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 |