IPosNav::StopCall

This method stops a call to the Positioning and Navigation device.

Syntax

HRESULT StopCall ( hPNDevice hPN, PNData_t Call );

Parameters

hPN
Handle to the Positioning and Navigation device in use.
Call
Type of data to retrieve from the Positioning and Navigation device. All PNData_t calls valid for the GetData function can be used for Call.

Return Values

One of the values described in the following table is returned.

Value
Description
S_OK Success
E_FAIL An unspecified error occurred.
E_INVALIDARG One or more arguments are invalid.
PNAPI_E_DEVICEUNAVAILABLE The Positioning and Navigation device is unavailable; it could be unplugged or dead.
PNAPI_E_NOCALLSTARTED No call has been started yet.

Remarks

If a call has been started using IPosNav::StartCall with the dwPeriod set to 0, then the call does not need to be stopped with IPosNav::StopCall. A value of 0 indicates the call is made once, and then stopped.

See Also

IPosNav::StartCall