TOKEN_PRIVILEGES structure (winnt.h)

Article
03/13/2024

La structure TOKEN_PRIVILEGES contient des informations sur un ensemble de privilèges pour un jeton d’accès.

Syntaxe

typedef struct _TOKEN_PRIVILEGES {
  DWORD               PrivilegeCount;
  LUID_AND_ATTRIBUTES Privileges[ANYSIZE_ARRAY];
} TOKEN_PRIVILEGES, *PTOKEN_PRIVILEGES;

Membres

PrivilegeCount

Ce paramètre doit être défini sur le nombre d’entrées dans le tableau Privilèges .

Privileges[ANYSIZE_ARRAY]

Spécifie un tableau de structures LUID_AND_ATTRIBUTES . Chaque structure contient le LUID et les attributs d’un privilège. Pour obtenir le nom du privilège associé à un LUID, appelez la fonction LookupPrivilegeName , en passant l’adresse du LUID comme valeur du paramètre lpLuid .

Important La constante ANYSIZE_ARRAY est définie sur 1 dans l’en-tête public Winnt.h. Pour créer ce tableau avec plusieurs éléments, vous devez allouer suffisamment de mémoire pour que la structure prenne en compte des éléments supplémentaires.

Les attributs d’un privilège peuvent être une combinaison des valeurs suivantes.

Valeur	Signification
SE_PRIVILEGE_ENABLED	Le privilège est activé.
SE_PRIVILEGE_ENABLED_BY_DEFAULT	Le privilège est activé par défaut.
SE_PRIVILEGE_REMOVED	Utilisé pour supprimer un privilège. Pour plus d’informations, consultez AdjustTokenPrivileges.
SE_PRIVILEGE_USED_FOR_ACCESS	Le privilège a été utilisé pour accéder à un objet ou à un service. Cet indicateur permet d’identifier les privilèges pertinents dans un jeu passé par une application cliente qui peut contenir des privilèges inutiles.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	winnt.h (inclure Windows.h)