Partager via


Fonction ZwAllocateLocallyUniqueId (ntddk.h)

La routine ZwAllocateLocallyUniqueId alloue un identificateur unique local (LUID).

Syntaxe

NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
  PLUID Luid
);

Paramètres

Luid

Pointeur vers une mémoire tampon allouée à l’appelant pour recevoir une copie de la structure LUID source. La mémoire tampon doit être d’au moins sizeof(LUID).

Valeur retournée

ZwAllocateLocallyUniqueId retourne STATUS_SUCCESS si l’opération réussit ou la valeur NTSTATUS appropriée si l’opération échoue. Si le paramètre de sortie ne peut pas être écrit dans, la routine retourne STATUS_ACCESS_VIOLATION.

Remarques

Le LUID alloué est unique au système local uniquement, et l’unicité est garantie uniquement jusqu’à ce que le système soit redémarré.

Si l’appel à la fonction ZwAllocateLocallyUniqueId se produit en mode utilisateur, vous devez utiliser le nom « NtAllocateLocallyUniqueId » au lieu de « ZwAllocateLocallyUniqueId ».

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête ntddk.h (inclure Ntddk.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm),SpNoWait(storport), StorPortStartIo(storport)

Voir aussi

LUID

Utilisation des versions Nt et Zw des routines natives des services système natifs