TOKEN_STATISTICS struttura (winnt.h)

Articolo
03/04/2024

La struttura TOKEN_STATISTICS contiene informazioni su un token di accesso. Un'applicazione può recuperare queste informazioni chiamando la funzione GetTokenInformation .

Sintassi

typedef struct _TOKEN_STATISTICS {
  LUID                         TokenId;
  LUID                         AuthenticationId;
  LARGE_INTEGER                ExpirationTime;
  TOKEN_TYPE                   TokenType;
  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel;
  DWORD                        DynamicCharged;
  DWORD                        DynamicAvailable;
  DWORD                        GroupCount;
  DWORD                        PrivilegeCount;
  LUID                         ModifiedId;
} TOKEN_STATISTICS, *PTOKEN_STATISTICS;

Members

TokenId

Specifica un identificatore univoco locale (LUID) che identifica questa istanza dell'oggetto token.

AuthenticationId

Specifica un LUID assegnato alla sessione che questo token rappresenta. Possono essere presenti molti token che rappresentano una singola sessione di accesso.

ExpirationTime

Specifica il momento in cui scade questo token. I tempi di scadenza per i token di accesso non sono attualmente supportati.

TokenType

Specifica un tipo di enumerazione TOKEN_TYPE che indica se il token è un token primario o di rappresentazione.

ImpersonationLevel

Specifica un tipo di enumerazione SECURITY_IMPERSONATION_LEVEL che indica il livello di rappresentazione del token. Questo membro è valido solo se TokenType è TokenImpersonation.

DynamicCharged

Specifica la quantità, in byte, della memoria allocata per archiviare la protezione predefinita e un identificatore di gruppo primario.

DynamicAvailable

Specifica la parte della memoria allocata per archiviare la protezione predefinita e un identificatore di gruppo primario non già in uso. Questo valore viene restituito come conteggio dei byte gratuiti.

GroupCount

Specifica il numero di identificatori di sicurezza del gruppo supplementari inclusi nel token.

PrivilegeCount

Specifica il numero di privilegi inclusi nel token.

ModifiedId

Specifica un LUID che cambia ogni volta che viene modificato il token. Un'applicazione può usare questo valore come test del fatto che un contesto di sicurezza è stato modificato dall'ultimo utilizzo.

Requisiti

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