ProviderIoctlOpen
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
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 |