IOCTL_HAL_GET_UUID
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Retorna este IOCTL o universalmente identificador exclusivo (UUID). O UUID é de 16-inteiro byte que é representado como uma seqüência de caracteres e é exclusivo. Cada cliente fino Windows deve ter um UUID ser licenciado com uma Windows NT Server 4.0, Terminal Server Edition (Terminal Server).
Este IOCTL está sendo substituído, começando com Windows Embedded CE 6.0. Sua funcionalidade foi integrado em IOCTL_HAL_GET_DEVICE_INFO, onde usando a SPI_GETUUID DWORD** é sinônimo de IOCTL_HAL_GET_UUID. Para obter mais informações, consulte Device Information IOCTL Unification.**
Parâmetros
dwIoControlCode
[no] Definir como IOCTL_HAL_GET_UUID para recuperar um UUID com base em um identificador hardware dispositivo OEM-defined.O OEM deve implementar a seção de codificar na OAL ao identificador de chamar a função de KernelIoControl.
- lpInBuf
[no] Definir como NULL.
- nInBufSize
[no] Definido como zero.
lpOutBuf
[in, Out] Na entrada, defina como o endereço de uma estrutura UUID alocada.Na saída, uma estrutura UUID preenchida.
- nOutBufSize
[no] Defina como o tamanho da estrutura de UUID.
lpBytesReturned
[in, Out] Na entrada, endereço de um DWORD que recebe o tamanho em bytes dos dados retornados.Na saída, defina como o número de bytes gravados para a reserva fornecida.
Valores Return
Se a função for bem-sucedido, o valor de retorno é TRUE.
Se a função falhar, o valor de retorno é zero ou FALSE.
Se o valor de retorno for FALSE, GetLastError irá ser definida como o erro encontrado ao processamento de solicitação.
Se GetLastError é igual a ERROR_NOT_SUPPORTED, IOCTL_HAL_GET_UUID não é com suporte sobre o dispositivo.
Se GetLastError é igual a ERROR_INSUFFICIENT_BUFFER, a reserva passada para o KernelIoControl função não era grande o suficiente.
Se GetLastError é igual a ERROR_INVALID_PARAMETER, os parâmetros para a função eram inválido.
Se não for fornecido suporte para IOCTL_HAL_GET_UUID dentro de função OEMIoControl ou se a solicitação falhar, o valor de retorno é FALSE.
Requisitos
| Header | pkfuncs.h |
| Windows Embedded CE | Windows CE 2.12 and later |
See Also
Reference
Concepts
Device Information IOCTL Unification