Share via

IOCTL_HAL_GET_UUID

  • Article

This IOCTL returns the universally unique identifier (UUID). The UUID is a 16-byte integer that is represented as a string and is guaranteed to be unique. Each Windows Thin Client must have a UUID to be licensed with a Windows NT Server 4.0, Terminal Server Edition (Terminal Server).

Parameters

  • dwIoControlCode
    [in] Set to IOCTL_HAL_GET_UUID to retrieve a UUID based upon an OEM-defined device hardware identifier. The OEM must implement the section of code in the OAL to handle the call to the KernelIoControl function.
  • lpInBuf
    [in] Set to NULL.
  • nInBufSize
    [in] Set to zero.
  • lpOutBuf
    [in, out] On input, set to the address of an allocated UUID structure. On output, a filled UUID structure.
  • nOutBufSize
    [in] Set to the size of the UUID structure.
  • lpBytesReturned
    [in, out] On input, address of a DWORD that receives the size in bytes of the data returned. On output, set to the number of bytes written to the supplied buffer.

Return Values

If the function succeeds, the return value is nonzero or TRUE. If the function fails, the return value is zero or FALSE. If support is not provided for IOCTL_HAL_GET_UUID within the OEMIoControl function or if the request fails, the return value is FALSE.

Requirements

OS Versions: Windows CE 2.12 and later.
Header: Pkfuncs.h.

See Also

KernelIoControl | OEMIoControl | Reading UUIDs

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.