TOKEN_STATISTICS-Struktur (ntifs.h)

Artikel
02/29/2024

Die TOKEN_STATISTICS-Struktur enthält Informationen zu einem Zugriffstoken. Ein Treiber kann diese Informationen abrufen, indem er SeQueryInformationToken oder ZwQueryInformationToken aufruft.

Syntax

typedef struct _TOKEN_STATISTICS {
  LUID                         TokenId;
  LUID                         AuthenticationId;
  LARGE_INTEGER                ExpirationTime;
  TOKEN_TYPE                   TokenType;
  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel;
  ULONG                        DynamicCharged;
  ULONG                        DynamicAvailable;
  ULONG                        GroupCount;
  ULONG                        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 aufgezählten Typ 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 aufgezählten Typ 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 Byte an, der für das Speichern einer Standardzugriffssteuerungsliste (DACL) und eines primären Gruppenbezeichners zugeordnet ist.

DynamicAvailable

Gibt den Teil des Arbeitsspeichers an, der für das Speichern einer DACL und eines primären Gruppenbezeichners 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 (SID) 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.