IDataSource.Cancel()

Description:

The Cancel method cancels an outstanding asynchronous +call made with a Logging Service API method.

If a cancel is sent, but the asynchronous call has already been completed, +then result.ErrorCode is set to 0 (success).

This is a synchronous method.

Syntax:

result = so.IDataSource.Cancel(criteria);

Arguments:

criteria:
+ +
This is an object with the TransactionID property +(number). criteria.TransactionID specifies the transaction +ID of the asynchronous call to cancel. The transaction ID is the result.TransactionID value +that was returned as part of the result of the initial call.
+ +

Return value:

The Cancel method returns an object that contains +an error code and an error message.

+ + + + + + + + + + + + + + + +

**Table:** Return value +properties for Cancel
+ Property +	+ Description +	+ Value +
+ `result.ErrorCode` +	+ This is a number that specifies a predefined error code. +	+ See Service API error codes . +
+ `result.ErrorMessage` +	+ This is a text string that describes the error. +	+ See Logging Service API error messages. +

Example code:

For the complete source of a sample widget that demonstrates how to +use this Service API, see the +full example.