NtOpenProcessToken 函式（ntifs.h）

發行項
02/07/2025

NtOpenProcessToken 例程會開啟與進程相關聯的存取令牌，並傳回可用來存取該令牌的句柄。

語法

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

參數

[in] ProcessHandle

處理要開啟其存取令牌的進程。句柄必須具有PROCESS_QUERY_INFORMATION存取權。使用 NtCurrentProcess 巨集，定義於 Ntddk.h中，以指定目前的進程。

[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	呼叫端沒有建立令牌句柄所需的許可權（SeSecurityPrivilege），其存取權是在 desiredAccess 參數中指定的存取權。
STATUS_QUOTA_EXCEEDED	進程的記憶體配額不足以配置令牌句柄。
STATUS_UNSUCCESSFUL	無法建立令牌句柄。