向公共语言运行时 (CLR) 告知主机已完成任务,并使 CLR 能够重用当前 ICLRTask 实例来表示另一个任务。
语法
HRESULT Reset (
[in] BOOL fFull
);
参数
fFull
[in] 如果运行时应重置所有与线程相关的静态值(除了与当前 ICLRTask 实例相关的安全和区域设置信息外),则为 true;否则为 false。
如果值为 true,则运行时重置使用 AllocateDataSlot 或 AllocateNamedDataSlot 存储的数据。
返回值
| HRESULT | 说明 |
|---|---|
| S_OK | 已成功返回 Reset。 |
| HOST_E_CLRNOTAVAILABLE | CLR 未加载到进程中,或 CLR 处于无法运行托管代码或处理调用的状态。 成功 |
| HOST_E_TIMEOUT | 调用超时。 |
| HOST_E_NOT_OWNER | 调用方未持有锁。 |
| HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
| E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
注解
CLR 可以回收以前创建的 ICLRTask 实例,以避免每次需要新任务时重复创建新实例的开销。 主机在完成任务后通过调用 ICLRTask::Reset(而不是 ICLRTask::ExitTask)来启用此功能。 以下列表汇总了 ICLRTask 实例的正常生命周期:
运行时创建新的
ICLRTask实例。运行时调用 IHostTaskManager::GetCurrentTask 获取对当前主机任务的引用。
运行时调用 IHostTask::SetCLRTask 将新实例与主机任务关联。
任务执行并完成。
主机通过调用
ICLRTask::ExitTask销毁任务。
Reset 通过两种方式改变此方案。 在上述步骤 5 中,主机调用 Reset 将任务重置为干净的状态,然后将 ICLRTask 实例与其关联的 IHostTask 实例分离。 如果需要,主机还可以缓存 IHostTask 实例以便重复使用。 在上述步骤 1 中,运行时从缓存中拉取回收的 ICLRTask,而不是创建新实例。
当主机还具有可重用的工作任务池时,此方法有效。 当主机销毁其 IHostTask 实例之一时,它会通过调用 ExitTask 销毁相应的 ICLRTask。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用