Share via


ProviderIoctlOpen

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

A Provider DLL implements this function. The Location Framework calls this export as a result of an application attempting to establish an IOCTL channel to the Provider pluging by calling LocationPluginOpen.

Syntax

HLOCATIONPLUGIN ProviderIoctlOpen(void);

Parameters

There are no parameters.

Return Value

On success, a HANDLE (psuedo-handle) that is meaningful to the Provider will be returned. This handle will be used to associate it with the application and the communication between them. Note that this value is not directly returned to the application, but instead the Location Framework has another level of indirection of HANDLEs.

On failure, 0 is returned. The Provider plugin must call SetLastError() to indicate to the application why it has failed.

Remarks

Unless there is a compelling reason, most plugins should not implement IOCTL channels and should use SetLastError(ERROR_NOT_SUPPORTED).

Requirements

Header lfplugin.h
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

Location Framework Plugin Functions