OpenProcessToken 函式 (processthreadsapi.h)

OpenProcessToken 函式會開啟與進程相關聯的存取令牌。

語法

BOOL OpenProcessToken(
  [in]  HANDLE  ProcessHandle,
  [in]  DWORD   DesiredAccess,
  [out] PHANDLE TokenHandle
);

[in] ProcessHandle

開啟其存取令牌之進程的句柄。進程必須具有PROCESS_QUERY_LIMITED_INFORMATION訪問許可權。如需詳細資訊，請參閱處理安全性和訪問許可權。

[in] DesiredAccess

指定存取遮罩，指定存取令牌的要求存取類型。這些要求的存取類型會與令牌的任意訪問控制清單 (DACL) 進行比較，以判斷要授與或拒絕哪些存取權。

如需存取令牌的訪問許可權清單，請參閱 Access-Token 對象的訪問許可權。

[out] TokenHandle

函式傳回時，識別新開啟存取令牌之句柄的指標。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

若要從未提高許可權的進程內取得提升許可權進程的句柄，這兩個進程都必須從相同的帳戶啟動。

如果正在檢查的進程是由不同的帳戶啟動，則檢查程式必須啟用SE_DEBUG_NAME許可權。如需詳細資訊，請參閱許可權常數 (授權) 。

若要關閉透過 TokenHandle 參數傳回的存取令牌句柄，請呼叫 CloseHandle。

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	processthreadsapi.h (包含 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll