IOCTL_CELOG_GETDESKTOPZONE (Windows CE 5.0)

Send Feedback

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 used only if an OEM replaces the default event tracking DLL, Celog.dll, with their own DLL. For information on how to replace Celog.dll, see Default Celog.dll Replacement.

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

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

See Also

IOCTL_CELOG_REPORTZONECHANGE | KernelLibIoControl | CeLog Event Tracking

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.