IPosNav::FindDevices

This method finds all connected Positioning and Navigation devices on the system.

Syntax

HRESULT FindDevices( ppPNDEVICE ppDevArray, DWORD *pdwNumDev );

Parameters

pDevArray
Pointer to an array of PNDEVICE pointers. This parameter returns the first item in a linked list of PNDEVICE structures. Destroy this list with the DeleteDeviceList method.
pdwNumDev
Pointer to the DWORD that contains the number of Positioning and Navigation devices found

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.
TYPE_E_DLLFUNCTIONNOTFOUND The method was not defined in the specified DLL.
REGDB_E_READREGDB A registry key could not be read.
PNAPI_E_INVALIDREGDBVALUE There is an invalid value in the registry.
PNAPI_E_REGDBCLOSEKEY A registry key cannot be closed.
PNAPI_E_MEMFREE Memory or resource cannot be freed.
PNAPI_E_BADOS There is an invalid operating system version.
E_OUTOFMEMORY The position and navigation API (PNAPI) is out of memory.

Remarks

The IPosNav::FindDevices method returns data for Positioning and Navigation devices in an unknown status, but does not return data for non-operational devices.

See Also

IPosNav::DeleteDeviceList, IPosNav::OpenDevice