NtOpenProcessToken 関数 (ntifs.h)

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

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

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtOpenProcessToken(
  [in]  HANDLE      ProcessHandle,
  [in]  ACCESS_MASK DesiredAccess,
  [out] PHANDLE     TokenHandle
);

パラメーター

[in] ProcessHandle

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

[in] DesiredAccess

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

[out] TokenHandle

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

戻り値

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

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

注釈

アクセストークンハンドルの属性を指定するには、代わりに NtOpenProcessTokenEx を使用します。

ハンドルには、ドライバーが実行されているコンテキストのプロセスからアクセスできます。

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

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

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