IHostSecurityManager::SetThreadToken 方法
設定目前執行中執行緒的控制代碼。
語法
HRESULT SetThreadToken (
[in] HANDLE hToken
);
參數
hToken
[in] 要針對目前執行中執行緒設定之語彙基元的控制代碼。
傳回值
HRESULT | 描述 |
---|---|
S_OK | SetThreadToken 已成功傳回。 |
HOST_E_CLRNOTAVAILABLE | 通用語言執行平台 (CLR) 尚未載入處理序,或 CLR 處於無法成功執行受控程式碼或處理呼叫的狀態。 |
HOST_E_TIMEOUT | 呼叫逾時。 |
HOST_E_NOT_OWNER | 呼叫端未擁有鎖定。 |
HOST_E_ABANDONED | 封鎖的執行緒或 Fiber 在其上等候時,事件遭到取消。 |
E_FAIL | 發生未知的重大失敗。 如果方法傳回 E_FAIL,則 CLR 就無法再用於處理序。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
備註
IHostSecurityManager::SetThreadToken
的行為類似於相同名稱的對應 Win32 函式,不同之處在於 Win32 函式可讓呼叫端傳入任意執行緒的控制代碼,而 IHostSecurityManager::SetThreadToken
只能讓語彙基元與目前執行中的執行緒產生關聯。
此 HANDLE
類型不符合 COM 規範,也就是其大小是作業系統特有,而且需要自訂封送處理。 因此,此語彙基元僅適用於 CLR 與主機之間的處理序內。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
程式庫:包含作為 MSCorEE.dll 中的資源
.NET Framework版本:自 2.0 起提供