TOKEN_STATISTICS 構造体 (winnt.h)

[アーティクル]
08/27/2023

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 を指定します。 1 つのログオンセッションを表すトークンが多数存在する場合があります。

ExpirationTime

このトークンの有効期限が切れる時刻を指定します。アクセストークンの有効期限は現在サポートされていません。

TokenType

トークンがプライマリトークンか偽装トークンかを示すTOKEN_TYPE列挙型を指定します。

ImpersonationLevel

トークンの偽装レベルを示す SECURITY_IMPERSONATION_LEVEL 列挙型を指定します。このメンバーは、 TokenType が TokenImpersonation の場合にのみ有効です。

DynamicCharged

既定の保護とプライマリグループ識別子を格納するために割り当てられたメモリの量をバイト単位で指定します。

DynamicAvailable

既定の保護と、まだ使用されていないプライマリグループ識別子を格納するために割り当てられたメモリの部分を指定します。この値は、空きバイト数として返されます。

GroupCount

トークンに含まれる補助グループセキュリティ識別子 (SID) の数を指定します。

PrivilegeCount

トークンに含まれる特権の数を指定します。

ModifiedId

トークンが変更されるたびに変更される LUID を指定します。アプリケーションでは、この値を、最後に使用されてからセキュリティコンテキストが変更されたかどうかをテストするために使用できます。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	winnt.h (Windows.h を含む)