共用方式為


ICLRTask::YieldTask 方法

要求 Common Language Runtime (CLR) 將目前 ICLRTask 執行個體所表示的工作放到一邊,並將處理器時間提供給其他工作使用。

HRESULT YieldTask ();

傳回值

HRESULT

描述

S_OK

YieldTask 已成功傳回。

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。

備註

主應用程式會呼叫 YieldTask,要求其他工作或處理序的處理器資源。 這個方法主要是要讓長時間執行的程式碼放棄 CPU 時間。 執行階段會嘗試將目前 ICLRTask 執行個體所表示的工作置於可以產生處理時間的狀態中,但不保證一定成功。

需求

**平台:**請參閱 .NET Framework 系統需求

**標頭:**MSCorEE.h

程式庫:包含做為 MSCorEE.dll 中的資源

**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

請參閱

參考

ICLRTask 介面

ICLRTaskManager 介面

IHostTask 介面

IHostTaskManager 介面