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 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。
E_FAIL 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。

注解

主机调用 YieldTask 为其他任务或进程请求处理器资源。 此方法主要用于允许长时间运行的代码放弃 CPU 时间。 运行时尝试将当前 ICLRTask 实例表示的任务置于可生成处理时间的状态,但不保证成功。

要求

平台:请参阅系统要求

标头:MSCorEE.h

库:作为资源包含在 MSCorEE.dll 中

.NET Framework 版本:自 2.0 起可用

另请参阅