OpenThreadToken 函式 (processthreadsapi.h)
OpenThreadToken函式會開啟與執行緒相關聯的存取權杖。
語法
BOOL OpenThreadToken(
[in] HANDLE ThreadHandle,
[in] DWORD DesiredAccess,
[in] BOOL OpenAsSelf,
[out] PHANDLE TokenHandle
);
參數
[in] ThreadHandle
開啟存取權杖之執行緒的控制碼。
[in] DesiredAccess
指定 存取遮罩 ，指定存取權杖的要求存取類型。 這些要求的存取類型會根據權杖的 任意存取控制清單 進行協調， (DACL) ，以判斷授與或拒絕哪些存取權。
如需存取權杖的存取權限清單，請參閱 Access-Token 物件的存取權限。
[in] OpenAsSelf
如果存取檢查是要針對進程層級 安全性內容進行，則為 TRUE。
FALSE 表示要針對呼叫 OpenThreadToken 函式之執行緒的目前安全性內容進行存取檢查。
OpenAsSelf參數可讓此函式的呼叫端在SecurityIdentification層級模擬權杖時，開啟指定執行緒的存取權杖。 如果沒有此參數，呼叫執行緒就無法在指定的執行緒上開啟存取權杖，因為無法使用 SecurityIdentification 模擬層級開啟執行層級物件。
[out] TokenHandle
接收新開啟存取權杖控制碼之變數的指標。
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 如果權杖具有匿名模擬層級，將不會開啟權杖，而且 OpenThreadToken 會將ERROR_CANT_OPEN_ANONYMOUS設定為錯誤。
備註
無法開啟具有匿名模擬層級的權杖。
呼叫CloseHandle以關閉透過TokenHandle參數傳回的存取權杖控制碼。
需求
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | processthreadsapi.h (包含 Windows.h) |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |