ZwOpenThreadTokenEx 関数 (ntifs.h)

[アーティクル]
12/21/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 パラメーターを使用すると、クライアントプロセスが列挙型の SecurityIdentification 偽装レベルを指定した場合に、サーバープロセスでクライアントプロセスのアクセストークンを開 SECURITY_IMPERSONATION_LEVEL。このパラメーターがないと、SecurityIdentification 偽装レベルを使用してエグゼクティブレベルのオブジェクトを開くことができず、クライアントのセキュリティコンテキストを使用して、呼び出し元のプロセスでクライアントのアクセストークンを開くことができません。

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

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

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

手記

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

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

必要条件

要件	価値
サポートされる最小クライアント	Windows XP
ターゲットプラットフォームの	万国
ヘッダー	ntifs.h (Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則をする	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

次の方法で共有

ZwOpenThreadTokenEx 関数 (ntifs.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース