IOCTL_CELOG_GETDESKTOPZONE

  • Article

This IOCTL 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.

Parameters

  • hModule
    [in] Handle to the DLL. Must be set to KMOD_CELOG.
  • dwIoControlCode
    [in] Set to IOCTL_CELOG_GETDESKTOPZONE.
  • lpInBuf
    [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
  • nInBufSize
    [in] Size of the string, in bytes, including the terminating NULL character.
  • lpOutBuf
    [out] Pointer to a DWORD that will receive the zone settings as specified in the registry of the host machine.
  • nOutBufSize
    [out] Set to sizeof(DWORD).
  • lpBytesReturned
    [out] Set to NULL.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

This IOCTL is only used if an OEM replaces the default event tracking DLL, Celog.dll, with their own DLL. For more information on how to replace Celog.dll, see Replacing the Default Celog.dll.

If the zone is not set in the registry of the host machine or if there is no host machine, 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

OS Versions: Windows CE .NET 4.0 and later.
Header: Pkfuncs.h.

See Also

IOCTL_CELOG_REGISTER | KernelLibIoControl | Event Tracking Implementation

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.