NtOpenThreadToken 関数 (ntifs.h)

[アーティクル]
02/29/2024

NtOpenThreadToken ルーチンは、スレッドに関連付けられているアクセストークンを開き、そのトークンへのアクセスに使用できるハンドルを返します。

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtOpenThreadToken(
  [in]  HANDLE      ThreadHandle,
  [in]  ACCESS_MASK DesiredAccess,
  [in]  BOOLEAN     OpenAsSelf,
  [out] PHANDLE     TokenHandle
);

パラメーター

[in] ThreadHandle

アクセストークンを開くスレッドを処理します。ハンドルにはTHREAD_QUERY_INFORMATIONアクセス権が必要です。現在のスレッドを指定するには 、NtCurrentThread マクロを使用します。

[in] DesiredAccess

ACCESS_MASK アクセストークンへのアクセスの要求された種類を指定する構造体です。これらの要求されたアクセスの種類は、トークンの随意アクセス制御リスト (DACL) と比較して、許可または拒否されるアクセス権を決定します。

[in] OpenAsSelf

NtOpenThreadToken を呼び出すスレッドのセキュリティコンテキストに対してアクセスチェックを行うか、呼び出し元スレッドのプロセスのセキュリティコンテキストに対して行うかを指定するブール値。

このパラメーターが FALSE の場合、アクセスチェックは呼び出し元スレッドのセキュリティコンテキストを使用して実行されます。スレッドがクライアントを偽装している場合、このセキュリティコンテキストはクライアントプロセスのものになる可能性があります。このパラメーターが TRUE の場合、アクセスチェックは、呼び出し元スレッドのプロセスのセキュリティコンテキストを使用して行われます。

[out] TokenHandle

新しく開かれたアクセストークンへのハンドルを受け取る呼び出し元によって割り当てられた変数へのポインター。

戻り値

NtOpenThreadToken は、STATUS_SUCCESSまたは適切なエラー状態を返します。考えられるエラー状態コードは次のとおりです。

リターンコード	説明
STATUS_ACCESS_DENIED
ThreadHandle にTHREAD_QUERY_INFORMATIONアクセスできませんでした。
STATUS_CANT_OPEN_ANONYMOUS	クライアントは SecurityAnonymous 偽装レベルを要求しました。ただし、匿名トークンを開くことはできません。詳細については、「 SECURITY_IMPERSONATION_LEVEL」を参照してください。
STATUS_INVALID_HANDLE	ThreadHandle が有効なハンドルではありません。
STATUS_NO_TOKEN	現在クライアントを偽装していないスレッドに関連付けられているトークンを開こうとしました。
STATUS_OBJECT_TYPE_MISMATCH	ThreadHandle はスレッドハンドルではありません。

注釈

NtOpenThreadToken は 、スレッドに関連付けられているアクセストークンを開き、そのトークンのハンドルを返します。

OpenAsSelf パラメーターを使用すると、クライアントプロセスがSECURITY_IMPERSONATION_LEVEL列挙型の SecurityIdentification 偽装レベルを指定した場合に、サーバープロセスでクライアントプロセスのアクセストークンを開くことができるようになります。このパラメーターがないと、SecurityIdentification 偽装レベルを使用してエグゼクティブレベルのオブジェクトを開くことができないため、呼び出し元プロセスはクライアントのセキュリティコンテキストを使用してクライアントのアクセストークンを開くことができません。

NtOpenThreadToken を呼び出して取得したハンドルは、最終的に NtClose を呼び出して解放する必要があります。

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

カーネルモードドライバーからの呼び出しの場合、Windows ネイティブシステムサービスルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なります。 ルーチンの NtXxx バージョンと ZwXxx バージョン間の関係の詳細については、「Using Nt and Zw Versions of the Native System Services Routines」を参照してください。