beautypg.com

Cancelvalidation – Echelon OpenLNS User Manual

Page 553

background image

OpenLNS Programmer's Reference

516

network

The

Network

object to be acted upon.

systemPath

The directory to which the backup is to

be copied.

The systemPath element must contain a

valid system path. If the destination

directory specified by this path does not

exist, that directory will be created, as

long as the first parent directory in the

path exists.
The directory permissions for this new

folder will be the default permissions

for the operating system on the

computer you are using. If the directory

specified by the systemPath element

already exists, it must be empty.
If there is any error during copying, or

if an invalid system path is supplied,

then the LCA#159

lcaErrUnableToCreateBackup

exception is thrown. Before returning

the error, all files copied by OpenLNS

up to that point will be deleted from the

destination directory, and the

destination directory will be deleted if it

was created by OpenLNS.

Added to API

LNS Release 3.20.

CancelValidation

Summary

Cancels a database validation that is in progress

.

You can initiate a database validation by invoking the

Validate method on the Network object. The

CancelValidation method must be called from the same

process that called the Validate method. Typically, it would

be called from a ProgressUpdate method callback. If this

method is called, and a database validation has not been

previously initiated with the Validate method, it will fail

silently.
It may take several minutes to stop the validation process

after you call the CancelValidation method. You can use the

ProgressUpdate method to check the status of the process

during this time period. When the validation has been

stopped, the LCA, #153 lcaErrDbValidationCancelled

exception will be thrown to notify the application.

Availability

Local clients.