ICLRTask::SwitchIn 方法
告知 Common Language Runtime (CLR),目前的 ICLRTask 執行個體所表示的工作此時處於可運作狀態。
HRESULT SwitchIn (
[in] HANDLE threadHandle
);
參數
- threadHandle
[in] 實體執行緒的控制代碼,目前的 ICLRTask 執行個體所表示的工作正在此執行緒上執行。
傳回值
HRESULT |
描述 |
---|---|
S_OK |
SwitchIn 已成功傳回。 |
HOST_E_CLRNOTAVAILABLE |
CLR 尚未載入至處理序中,或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。 |
HOST_E_TIMEOUT |
呼叫已逾時。 |
HOST_E_NOT_OWNER |
呼叫端不具備鎖定功能。 |
HOST_E_ABANDONED |
已封鎖執行緒或 Fiber 在等候事件時,該事件已遭取消。 |
E_FAIL |
發生未知的重大錯誤。 當方法傳回 E_FAIL 時,便無法在處理序內使用 CLR。 對裝載方法的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
HOST_E_INVALIDOPERATION |
先前沒有呼叫 ICLRTask::SwitchOut 方法就呼叫 SwitchIn。 |
備註
threadHandle 參數表示作業系統執行緒的控制代碼,且目前的 ICLRTask 執行個體所表示的工作已經在此執行緒上排程。 如果針對此執行緒發生模擬動作,在工作中切換之前必須先呼叫 IHostSecurityManager::RevertToSelf。
注意事項 |
---|
沒有先呼叫 SwitchOut 就呼叫 SwitchIn 便會失敗,並且 HRESULT 的值為 HOST_E_INVALIDOPERATION。 |
需求
**平台:**請參閱 .NET Framework 系統需求。
**標頭:**MSCorEE.h
程式庫:包含做為 MSCorEE.dll 中的資源
**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0