structure TOKEN_STATISTICS (ntifs.h)

Article
12/21/2024

La structure TOKEN_STATISTICS contient des informations sur un jeton d’accès. Un pilote peut récupérer ces informations en appelant SeQueryInformationToken ou ZwQueryInformationToken.

Syntaxe

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;

Membres

TokenId

Spécifie un identificateur localement unique (LUID) qui identifie cette instance de l’objet de jeton.

AuthenticationId

Spécifie un LUID affecté à la session que ce jeton représente. Il peut y avoir de nombreux jetons représentant une session d’ouverture de session unique.

ExpirationTime

Spécifie l’heure à laquelle ce jeton expire. Les délais d’expiration des jetons d’accès ne sont actuellement pas pris en charge.

TokenType

Spécifie un type énuméré TOKEN_TYPE indiquant si le jeton est un jeton principal ou un jeton d’emprunt d’identité.

ImpersonationLevel

Spécifie un type énuméré SECURITY_IMPERSONATION_LEVEL indiquant le niveau d’emprunt d’identité du jeton. Ce membre est valide uniquement si le TokenType est TokenImpersonation.

DynamicCharged

Spécifie la quantité, en octets, de mémoire allouée pour stocker une liste de contrôle d’accès (DACL) et un identificateur de groupe principal par défaut.

DynamicAvailable

Spécifie la partie de la mémoire allouée pour le stockage d’un identificateur de groupe principal et DACL qui n’est pas déjà utilisé. Cette valeur est retournée sous la forme d’un nombre d’octets libres.

GroupCount

Spécifie le nombre d’identificateurs de sécurité de groupe supplémentaires (SID) inclus dans le jeton.

PrivilegeCount

Spécifie le nombre de privilèges inclus dans le jeton.

ModifiedId

Spécifie un LUID qui change chaque fois que le jeton est modifié. Une application peut utiliser cette valeur comme test de savoir si un contexte de sécurité a changé depuis sa dernière utilisation.