Share via


ProviderIoctlCall (Windows Embedded CE 6.0)

1/6/2010

A Provider DLL implements this function. The Location Framework calls this export as a result of an application calling LocationPluginIOCTL.

Syntax

DWORD  ProviderIoctlCall(
   HANDLE hProv, 
      DWORD  dwCode, 
   BYTE*  pBufIn, 
   DWORD  cbIn, 
      BYTE*  pBufOut, 
   DWORD* pcbOut
);

Parameters

Return Value

The return value is passed back directly to the application.

If successful, return ERROR_SUCCESS.

If unsuccessful, return an error code.

Remarks

Great care should be taken in processing user data, because it is possible that a malicious application could crash the Provider, the Location Framework, or even servicesd.exe if the Provider does not properly check the parameters.

The Location Framework will automatically map the pointers from the calling applications space into servicesd.exe space. If the caller has passed a structure that contains embedded pointers, it is the responsibility of the plugin DLL to map these pointers into the process space.

The pBufIn can only be used for reading in data; if the plugin writes any data into this buffer, it will not be copied out to the calling application’s memory space. Similarly if the application passes data in the pBufOut parameter, it will be not be copied into servicesd.exe’s process space.

Requirements

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

See Also

Reference

Location Framework Plugin Functions