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
Uso di nt e zw versioni delle routine di Servizi di sistema nativo