ILocation.CancelNotification()

Description:

The CancelNotification method cancels an outstanding asynchronous call.

This is a synchronous method.

Syntax:

result = so.ILocation.CancelNotification(criteria);

Arguments:

criteria:

This is an object that specifies whether to cancel a GetLocation call or a Trace call. The object must contain the CancelRequestType property (string) that is used to specify the type of call to cancel. The possible values for criteria.CancelRequestType are:
- "GetLocCancel" cancels an asynchronous GetLocation call.
- "TraceCancel" cancels a Trace call.

Return value:

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

**Table:** Return value properties for CancelNotification
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 Location 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.