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 ha esito negativo. Se il parametro di output non può essere scritto in, la routine restituisce STATUS_ACCESS_VIOLATION.

Commenti

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

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

Per le chiamate dai driver in modalità kernel, le versioni NtXxx e ZwXxx 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 Uso di nt e zw versioni delle routine di Servizi di sistema nativo.

Requisiti

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	HwStorPortProhibitedDDDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Vedi anche

LUID

Uso di nt e zw versioni delle routine di Servizi di sistema nativo