TOKEN_STATISTICS-Struktur (winnt.h)

Artikel
03/13/2024

Die TOKEN_STATISTICS-Struktur enthält Informationen zu einem Zugriffstoken. Eine Anwendung kann diese Informationen abrufen, indem sie die GetTokenInformation-Funktion aufruft.

Syntax

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;

Member

TokenId

Gibt einen lokal eindeutigen Bezeichner (LUID) an, der diese instance des Tokenobjekts identifiziert.

AuthenticationId

Gibt eine LUID an, die der Sitzung zugewiesen ist, die dieses Token darstellt. Es kann viele Token geben, die eine einzelne Anmeldesitzung darstellen.

ExpirationTime

Gibt den Zeitpunkt an, zu dem dieses Token abläuft. Ablaufzeiten für Zugriffstoken werden derzeit nicht unterstützt.

TokenType

Gibt einen TOKEN_TYPE Enumerationstyp an, der angibt, ob es sich bei dem Token um ein primäres Token oder ein Identitätswechseltoken handelt.

ImpersonationLevel

Gibt einen SECURITY_IMPERSONATION_LEVEL Enumerationstyp an, der die Identitätswechselebene des Tokens angibt. Dieser Member ist nur gültig, wenn tokenType TokenImpersonation ist.

DynamicCharged

Gibt die Menge des Arbeitsspeichers in Bytes an, der für das Speichern des Standardschutzes und eines primären Gruppenbezeichners zugeordnet ist.

DynamicAvailable

Gibt den Teil des Arbeitsspeichers an, der für das Speichern des Standardschutzes und einen primären Gruppenbezeichner zugewiesen ist, der noch nicht verwendet wird. Dieser Wert wird als Anzahl von freien Bytes zurückgegeben.

GroupCount

Gibt die Anzahl der zusätzlichen Gruppensicherheits-IDs (SIDs) an, die im Token enthalten sind.

PrivilegeCount

Gibt die Anzahl der im Token enthaltenen Berechtigungen an.

ModifiedId

Gibt eine LUID an, die sich bei jeder Änderung des Tokens ändert. Eine Anwendung kann diesen Wert als Test verwenden, ob sich ein Sicherheitskontext seit seiner letzten Verwendung geändert hat.

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)