次の方法で共有

ZwOpenProcessTokenEx 関数 (ntifs.h)

  • [アーティクル]

ZwOpenProcessTokenEx ルーチンは、プロセスに関連付けられているアクセス トークンを開きます。

構文

NTSYSAPI NTSTATUS ZwOpenProcessTokenEx(
  [in]  HANDLE      ProcessHandle,
  [in]  ACCESS_MASK DesiredAccess,
  [in]  ULONG       HandleAttributes,
  [out] PHANDLE     TokenHandle
);

パラメーター

[in] ProcessHandle

アクセス トークンを開くプロセスを処理します。 ハンドルにはPROCESS_QUERY_INFORMATIONアクセス権が必要です。 Ntddk.h で定義されている NtCurrentProcess マクロを使用して、現在のプロセスを指定します。

[in] DesiredAccess

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

[in] HandleAttributes

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

[out] TokenHandle

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

戻り値

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

リターン コード 形容
STATUS_ACCESS_DENIED ProcessHandle にPROCESS_QUERY_INFORMATIONアクセス権がありませんでした。
STATUS_INSUFFICIENT_RESOURCES 新しいトークン ハンドルを割り当てませんでした。
STATUS_INVALID_HANDLE ProcessHandle は有効なハンドルではありません。
STATUS_INVALID_PARAMETER 指定した HandleAttributes にOBJ_KERNEL_HANDLEが含まれていませんでした。
STATUS_OBJECT_TYPE_MISMATCH ProcessHandle はプロセス ハンドルではありません。
STATUS_PRIVILEGE_NOT_HELD 呼び出し元には、DesiredAccess パラメーターで指定されたアクセス権を持つトークン ハンドルを作成するために必要な特権 (SeSecurityPrivilege) がありません。
STATUS_QUOTA_EXCEEDED プロセスのメモリ クォータでは、トークン ハンドルを割り当てるのに十分ではありません。
STATUS_UNSUCCESSFUL トークン ハンドルを作成できませんでした。

備考

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

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

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

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

手記

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

カーネル モード ドライバーからの呼び出しの場合、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)

関連項目

ACCESS_MASK

ACL

PsDereferencePrimaryToken の

ネイティブ システム サービス ルーチンの Nt バージョンと Zw バージョンを使用した

ZwClose

ZwOpenThreadTokenEx