IOCTL_CELOG_GETDESKTOPZONE (Compact 2013)

10/16/2014

This I/O control message is used by the Celog event-tracking module to query the default zone settings in the registry of the host machine, if one is present. Send this message with KernelLibIoControl.

Syntax

BOOL KernelLibIoControl(
    HANDLE hDevice,           // handle to the DLL
    DWORD dwIoControlCode,    // use CELOG_GETDESKTOPZONE
    LPVOID lpInBuffer,        // pointer to input buffer
    DWORD nInBufferSize,      // input buffer size
    LPVOID lpOutBuffer,       // pointer to output buffer
    DWORD nOutBufferSize,     // output buffer size
    LPDWORD lpBytesReturned   // number of bytes returned
);

Parameters

• hDevice
  [in] Handle to the DLL. Must be set to KMOD_CELOG.

• dwIoControlCode
  [in] The control code for the operation. Use CELOG_GETDESKTOPZONE for this operation.

• lpInBuffer
  [in] Pointer to a Unicode string containing the name of the zone. The three available zones are specified by the following available strings:

  • CeLogZoneCE
  • CeLogZoneUser
  • CeLogZoneProcess

• nInBufferSize
  [in] Size of the string, in bytes, including the terminating NULL character.

• lpOutBuffer
  [out] Pointer to a DWORD that will receive the zone settings as specified in the registry of the host machine.

• nOutBufferSize
  [out] Set to sizeof(DWORD).

• lpBytesReturned
  [out] Set to NULL.

Return Values

Returns TRUE if successful; otherwise, returns FALSE.

Remarks

This I/O control is used only if an OEM replaces the default event tracking DLL, Celog.dll, with their own DLL.

If the zone is not set in the registry of the host computer, or if there is no host computer, the default zone settings are returned. For CeLogZoneCE and CeLogZoneUser, the default zone setting is 0xFFBFFFFF. For CeLogZoneProcess, the default zone setting is 0xFFFFFFFF.

Requirements

Header

pkfuncs.h

See Also

Reference

Tools IOCTLs
IOCTL_CELOG_REPORTZONECHANGE