struttura TOKEN_PRIVILEGES (winnt.h)

Articolo
03/04/2024

La struttura TOKEN_PRIVILEGES contiene informazioni su un set di privilegi per un token di accesso.

Sintassi

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

Members

PrivilegeCount

Deve essere impostato sul numero di voci nella matrice Privilegi .

Privileges[ANYSIZE_ARRAY]

Specifica una matrice di strutture LUID_AND_ATTRIBUTES . Ogni struttura contiene il LUID e gli attributi di un privilegio. Per ottenere il nome del privilegio associato a un LUID, chiamare la funzione LookupPrivilegeName , passando l'indirizzo del LUID come valore del parametro lpLuid .

Importante La costante ANYSIZE_ARRAY è definita come 1 nell'intestazione pubblica Winnt.h. Per creare questa matrice con più di un elemento, è necessario allocare memoria sufficiente affinché la struttura tenga conto di elementi aggiuntivi.

Gli attributi di un privilegio possono essere una combinazione dei valori seguenti.

Valore	Significato
SE_PRIVILEGE_ENABLED	Il privilegio è abilitato.
SE_PRIVILEGE_ENABLED_BY_DEFAULT	Il privilegio è abilitato per impostazione predefinita.
SE_PRIVILEGE_REMOVED	Usato per rimuovere un privilegio. Per informazioni dettagliate, vedere AdjustTokenPrivileges.
SE_PRIVILEGE_USED_FOR_ACCESS	Il privilegio è stato usato per ottenere l'accesso a un oggetto o a un servizio. Questo flag viene usato per identificare i privilegi pertinenti in un set passato da un'applicazione client che può contenere privilegi non necessari.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winnt.h (include Windows.h)