Função ZwAllocateLocallyUniqueId (ntddk.h)

A rotina de ZwAllocateLocallyUniqueId aloca um identificador localmente exclusivo (LUID).

Sintaxe

NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
  PLUID Luid
);

Parâmetros

Luid

Ponteiro para um buffer alocado por chamador para receber uma cópia da estrutura LUID de origem. O buffer deve ter pelo menos tamanhos de(LUID).

Valor de retorno

ZwAllocateLocallyUniqueId retornará STATUS_SUCCESS se a operação for bem-sucedida ou o valor NTSTATUS apropriado se a operação falhar. Se o parâmetro de saída não puder ser gravado, a rotina retornará STATUS_ACCESS_VIOLATION.

Observações

A LUID alocada é exclusiva apenas para o sistema local e a exclusividade só é garantida até que o sistema seja reiniciado na próxima vez.

Se a chamada para a função ZwAllocateLocallyUniqueId ocorrer no modo de usuário, você deverá usar o nome "NtAllocateLocallyUniqueId" em vez de "ZwAllocateLocallyUniqueId".

Para chamadas de drivers no modo kernel, as versões NtXxx e Zwxxx versões de uma rotina dos Serviços de Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas de serviços do sistema nativo.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ntddk.h (inclua Ntddk.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Consulte também

LUID

usando versões Nt e Zw das rotinas de serviços do sistema nativo