ZwOpenThreadTokenEx 関数 (ntifs.h)

[アーティクル]
03/05/2024

ZwOpenThreadTokenEx ルーチンは、スレッドに関連付けられているアクセストークンを開きます。

構文

NTSYSAPI NTSTATUS ZwOpenThreadTokenEx(
  [in]  HANDLE      ThreadHandle,
  [in]  ACCESS_MASK DesiredAccess,
  [in]  BOOLEAN     OpenAsSelf,
  [in]  ULONG       HandleAttributes,
  [out] PHANDLE     TokenHandle
);

パラメーター

[in] ThreadHandle

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

[in] DesiredAccess

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

[in] OpenAsSelf

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

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

[in] HandleAttributes

作成されたハンドルの属性。現在、OBJ_KERNEL_HANDLEのみがサポートされています。呼び出し元がシステムプロセスコンテキストで実行されていない場合は、このパラメーターにOBJ_KERNEL_HANDLEを指定する必要があります。

[out] TokenHandle

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

戻り値

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

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

注釈

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

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

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

システムプロセス以外のプロセスコンテキストで実行されるドライバールーチンは、ZwOpenThreadTokenEx の HandleAttributes パラメーターのOBJ_KERNEL_HANDLE属性を設定する必要があります。これにより、 ZwOpenThreadTokenEx によって返されるハンドルの使用が、カーネルモードで実行されているプロセスに制限されます。それ以外の場合は、ドライバーが実行されているコンテキスト内のプロセスによってハンドルにアクセスできます。

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

注意

ZwOpenThreadTokenEx 関数の呼び出しがユーザーモードで行われる場合は、"ZwOpenThreadTokenEx" の代わりに "NtOpenThreadTokenEx" という名前を使用する必要があります。

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

要件

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