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

• hProv
  Handle returned by ProviderIoctlOpen function.

• dwCode
  dwCode passed by LocationPluginIOCTL.

• pBufIn
  pBufIn passed by LocationPluginIOCTL.

• cbIn
  cbIn passed by LocationPluginIOCTL.

• pBufOut
  pBufOut passed by LocationPluginIOCTL.

• pcbOut
  pcbOut passed by LocationPluginIOCTL.

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

See Also

Reference

Location Framework Plugin Functions