estrutura TOKEN_STATISTICS (winnt.h)

Artigo
03/13/2024

A estrutura TOKEN_STATISTICS contém informações sobre um token de acesso. Um aplicativo pode recuperar essas informações chamando a função GetTokenInformation .

Sintaxe

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;

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 tipo de enumeração TOKEN_TYPE indicando se o token é um token primário ou de representação.

ImpersonationLevel

Especifica um tipo de enumeração SECURITY_IMPERSONATION_LEVEL indicando 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 a proteção padrão e um identificador de grupo primário.

DynamicAvailable

Especifica a parte da memória alocada para armazenar a proteção padrão 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 SIDs ( identificadores de segurança de grupo suplementares ) 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.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	winnt.h (inclua Windows.h)