Função ZwAllocateLocallyUniqueId (ntddk.h)

  • Artigo

A rotina ZwAllocateLocallyUniqueId aloca um LUID (identificador local exclusivo).

Sintaxe

NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
  PLUID Luid
);

Parâmetros

Luid

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

Retornar valor

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.

Comentários

O LUID alocado é exclusivo apenas para o sistema local e a exclusividade é garantida somente até que o sistema seja reiniciado.

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 de uma rotina dos Serviços do 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 dos Serviços de Sistema Nativo.

Requisitos

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

Confira também

LUID

Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo