TOKEN_PRIVILEGES-Struktur (winnt.h)

Artikel
03/04/2024

Die TOKEN_PRIVILEGES-Struktur enthält Informationen zu einem Satz von Berechtigungen für ein Zugriffstoken.

Syntax

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

Member

PrivilegeCount

Dies muss auf die Anzahl der Einträge im Privileges-Array festgelegt werden.

Privileges[ANYSIZE_ARRAY]

Gibt ein Array von LUID_AND_ATTRIBUTES-Strukturen an. Jede Struktur enthält die LUID und attribute einer Berechtigung. Um den Namen der einer LUID zugeordneten Berechtigungen abzurufen, rufen Sie die LookupPrivilegeName-Funktion auf, und übergeben Sie die Adresse der LUID als Wert des lpLuid-Parameters .

Wichtig Die Konstante ANYSIZE_ARRAY wird im öffentlichen Header Winnt.h als 1 definiert. Um dieses Array mit mehr als einem Element zu erstellen, müssen Sie genügend Arbeitsspeicher zuweisen, damit die Struktur zusätzliche Elemente berücksichtigen kann.

Die Attribute einer Berechtigung können eine Kombination der folgenden Werte sein.

Wert	Bedeutung
SE_PRIVILEGE_ENABLED	Die Berechtigung ist aktiviert.
SE_PRIVILEGE_ENABLED_BY_DEFAULT	Die Berechtigung ist standardmäßig aktiviert.
SE_PRIVILEGE_REMOVED	Wird verwendet, um eine Berechtigung zu entfernen. Weitere Informationen finden Sie unter AdjustTokenPrivileges.
SE_PRIVILEGE_USED_FOR_ACCESS	Die Berechtigung wurde verwendet, um Zugriff auf ein Objekt oder einen Dienst zu erhalten. Dieses Flag wird verwendet, um die relevanten Berechtigungen in einer Gruppe zu identifizieren, die von einer Clientanwendung übergeben wird, die möglicherweise unnötige Berechtigungen enthält.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winnt.h (windows.h einschließen)