ICLRTask::YieldTask 方法

请求公共语言运行时 CLR) 搁置当前 ICLRTask 实例所表示的任务,并将处理器时间让与其他任务。

HRESULT YieldTask ();

返回值

HRESULT

说明

S_OK

YieldTask 已成功返回。

HOST_E_CLRNOTAVAILABLE

CLR 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。

HOST_E_TIMEOUT

调用超时。

HOST_E_NOT_OWNER

调用方不拥有锁。

HOST_E_ABANDONED

事件在被阻止的线程或纤程正在等待它时被取消。

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 接口