SeQueryInformationToken 関数 (ntifs.h)

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

SeQueryInformationToken ルーチンは、アクセストークンに関する指定された種類の情報を取得します。呼び出し元プロセスには、情報を取得するための適切なアクセス権が必要です。

構文

NTSTATUS SeQueryInformationToken(
  [in]  PACCESS_TOKEN           Token,
  [in]  TOKEN_INFORMATION_CLASS TokenInformationClass,
  [out] PVOID                   *TokenInformation
);

パラメーター

[in] Token

情報の取得元となるアクセストークンへのポインター。 TokenInformationClass が TokenSource に設定されている場合、ハンドルにはTOKEN_QUERY_SOURCEアクセス権が必要です。他のすべての TokenInformationClass 値については、ハンドルにTOKEN_QUERYアクセス権が必要です。

[in] TokenInformationClass

取得する情報の種類を識別するTOKEN_INFORMATION_CLASS列挙型の値。

[out] TokenInformation

STATUS_SUCCESSが返された場合、 TokenInformation は、要求された情報を保持するバッファーのアドレスを含む場所へのポインターを受け取ります。この情報バッファーの形式は、次の表に示すように、 TokenInformationClass の値によって異なります。バッファーは、ページプールから SeQueryInformationToken によって割り当てられることに注意してください。このバッファーは、最終的に ExFreePool を使用して呼び出し元によって解放される必要があります。

値	説明
TokenDefaultDacl	バッファーは、新しく作成されたオブジェクトの既定の DACL を含む TOKEN_DEFAULT_DACL 構造体を受け取ります。
TokenGroups	バッファーは、トークンに関連付けられているグループアカウントを含む TOKEN_GROUPS 構造体を受け取ります。
TokenImpersonationLevel	バッファーは、トークンの偽装レベルを示す SECURITY_IMPERSONATION_LEVEL 値を受け取ります。アクセストークンが偽装トークンでない場合、 SeQueryInformationToken の呼び出しは失敗します。
TokenOwner	バッファーは、新しく作成されたオブジェクトの既定の所有者セキュリティ識別子 (SID) を含むTOKEN_OWNER構造体を受け取ります。
TokenPrimaryGroup	バッファーは、新しく作成されたオブジェクトの既定のプライマリグループ SID を含む TOKEN_PRIMARY_GROUP 構造体を受け取ります。
TokenPrivileges	バッファーは、トークンの特権を含む TOKEN_PRIVILEGES 構造体を受け取ります。
TokenSessionId	バッファーは、トークンに関連付けられているターミナルサービスセッション識別子を示す DWORD 値 (ポインターではない) を受け取ります。トークンがターミナルサーバーコンソールセッションに関連付けられている場合、セッション識別子は 0 です。 0 以外のセッション識別子は、ターミナルサービスクライアントセッションを示します。ターミナルサービス以外の環境では、セッション識別子は 0 です。
TokenSource	バッファーは、トークンのソースを含む TOKEN_SOURCE 構造体を受け取ります。この情報TOKEN_QUERY_SOURCE取得するには、アクセス権が必要です。
TokenStatistics	バッファーは、さまざまなトークン統計を含む TOKEN_STATISTICS 構造体を受け取ります。
Tokentype	バッファーは、トークンがプライマリトークンか偽装トークンかを示す TOKEN_TYPE 値を受け取ります。
TokenUser	バッファーは、トークンのユーザーアカウントを含む TOKEN_USER 構造体を受け取ります。
TokenIntegrityLevel	バッファーは、トークンの整合性レベルを指定する DWORD 値 (ポインターではない) を受け取ります。

戻り値

リターンコード	説明
STATUS_SUCCESS	SeQueryInformationToken の呼び出しが成功しました。
STATUS_INVALID_INFO_CLASS	TokenInformationClass に無効な値が指定されました。

注釈

セキュリティとアクセス制御の詳細については、ドライバー開発者向けの Windows セキュリティモデルと、Windows SDK のこれらのトピックに関するドキュメントを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL