TOKEN_STATISTICS 結構 (winnt.h)

發行項
03/13/2024

TOKEN_STATISTICS 結構包含存取令牌的相關信息。應用程式可以藉由呼叫 GetTokenInformation 函式來擷取這項資訊。

語法

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;

成員

TokenId

指定本機唯一標識碼 (LUID) ，以識別令牌對象的這個實例。

AuthenticationId

指定指派給此令牌所代表之會話的 LUID。有許多令牌代表單一登錄會話。

ExpirationTime

指定此令牌到期的時間。目前不支援存取令牌的到期時間。

TokenType

指定 TOKEN_TYPE 列舉型別，指出令牌是否為主要或模擬令牌。

ImpersonationLevel

指定 SECURITY_IMPERSONATION_LEVEL 列舉型別，指出令牌的模擬層級。只有當 TokenType 是 TokenImpersonation 時，這個成員才有效。

DynamicCharged

指定配置用於儲存預設保護和主要群組標識符的記憶體數量，以位元組為單位。

DynamicAvailable

指定配置用來儲存預設保護的記憶體部分，以及尚未使用的主要群組標識碼。這個值會以可用位元組的計數傳回。

GroupCount

指定令牌中包含的補充群組安全性標識子數目， (SID) 。

PrivilegeCount

指定令牌中包含的許可權數目。

ModifiedId

指定每次修改令牌時都會變更的 LUID。應用程式可以使用此值作為安全性內容自上次使用后是否已變更的測試。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	winnt.h (包括 Windows.h)