estrutura TOKEN_STATISTICS (ntifs.h)

Artigo
02/27/2024

A estrutura TOKEN_STATISTICS contém informações sobre um token de acesso. Um driver pode recuperar essas informações chamando SeQueryInformationToken ou ZwQueryInformationToken.

Sintaxe

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;

Membros

TokenId

Especifica um LUID (identificador local exclusivo) que identifica essa instância do objeto de token.

AuthenticationId

Especifica um LUID atribuído à sessão que esse token representa. Pode haver muitos tokens que representam uma única sessão de logon.

ExpirationTime

Especifica a hora em que esse token expira. No momento, não há suporte para tempos de expiração para tokens de acesso.

TokenType

Especifica um TOKEN_TYPE tipo enumerado que indica se o token é um token primário ou de representação.

ImpersonationLevel

Especifica um SECURITY_IMPERSONATION_LEVEL tipo enumerado que indica o nível de representação do token. Esse membro só será válido se o TokenType for TokenImpersonation.

DynamicCharged

Especifica a quantidade, em bytes, de memória alocada para armazenar uma DACL (lista de controle de acesso) padrão e um identificador de grupo primário.

DynamicAvailable

Especifica a parte da memória alocada para armazenar uma DACL e um identificador de grupo primário que ainda não está em uso. Esse valor é retornado como uma contagem de bytes gratuitos.

GroupCount

Especifica o número de SID (identificadores de segurança de grupo) complementares incluídos no token.

PrivilegeCount

Especifica o número de privilégios incluídos no token.

ModifiedId

Especifica um LUID que é alterado sempre que o token é modificado. Um aplicativo pode usar esse valor como um teste de se um contexto de segurança foi alterado desde que foi usado pela última vez.