Share via


IOCTL_CELOG_GETDESKTOPZONE (Windows Embedded CE 6.0)

1/5/2010

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

Header pkfuncs.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Tools IOCTLs
IOCTL_CELOG_REPORTZONECHANGE

Other Resources

KernelLibIoControl
CeLog Event Tracking