共用方式為

ICLRTask::YieldTask 方法

  • 發行項

要求通用語言執行平台 (CLR) 擱置目前 ICLRTask 執行個體所代表的工作，並且讓處理器時間可供其他工作使用。

語法

HRESULT YieldTask ();

傳回值

HRESULT 描述
S_OK YieldTask 已成功傳回。
HOST_E_CLRNOTAVAILABLE CLR 尚未載入處理序，或 CLR 處於無法執行受控程式碼或成功處理呼叫的狀態。
HOST_E_TIMEOUT 呼叫逾時。
HOST_E_NOT_OWNER 呼叫端未擁有鎖定。
HOST_E_ABANDONED 封鎖的執行緒或 Fiber 在其上等候時，事件遭到取消。
E_FAIL 發生未知的重大失敗。 如果方法傳回 E_FAIL，則 CLR 就無法再用於處理序。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。

備註

主機呼叫 YieldTask 以要求其他工作或處理序的處理器資源。 此方法主要用來允許長時間執行的程式碼放棄 CPU 時間。 執行階段會嘗試將目前 ICLRTask 執行個體所代表的工作置於可產生處理時間的狀態，但不保證成功。

規格需求

平台：請參閱系統需求。

標題： MSCorEE.h

程式庫：包含作為 MSCorEE.dll 中的資源

.NET Framework版本：自 2.0 起提供

另請參閱