Funzione ZwAllocateLocallyUniqueId (ntddk.h)

La routine ZwAllocateLocallyUniqueId alloca un identificatore univoco locale (LUID).

Sintassi

NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
  PLUID Luid
);

Parametri

Luid

Puntatore a un buffer allocato dal chiamante per ricevere una copia della struttura LUID di origine. Il buffer deve essere almeno sizeof(LUID).

Valore restituito

ZwAllocateLocallyUniqueId restituisce STATUS_SUCCESS se l'operazione ha esito positivo o il valore NTSTATUS appropriato se l'operazione non riesce. Se il parametro di output non può essere scritto in , la routine restituisce STATUS_ACCESS_VIOLATION.

Osservazioni

Il LUID allocato è univoco solo per il sistema locale e l'univocità è garantita solo fino al successivo riavvio del sistema.

Se la chiamata alla funzione ZwAllocateLocallyUniqueId viene eseguita in modalità utente, è necessario usare il nome "NtAllocateLocallyUniqueId" anziché "ZwAllocateLocallyUniqueId".

Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	ntddk.h (include Ntddk.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regole di conformità DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Vedere anche

LUID

uso di versioni Nt e Zw delle routine di Servizi di sistema nativi