通知公共语言运行时(CLR)主机已完成任务,并使 CLR 能够重复使用当前的 ICLRTask 实例来表示另一个任务。
Syntax
HRESULT Reset (
[in] BOOL fFull
);
参数
fFull [in] true如果运行时除了与当前 ICLRTask 实例相关的安全和区域设置信息外,还应重置所有与线程相关的静态值;否则为 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::ResetICLRTask::ExitTask 来启用此功能。 以下列表汇总了实例的 ICLRTask 正常生命周期:
运行时创建一个新
ICLRTask实例。运行时调用 IHostTaskManager::GetCurrentTask 以获取对当前主机任务的引用。
运行时调用 IHostTask::SetCLRTask 以将新实例与主机任务相关联。
任务执行并完成。
主机通过调用
ICLRTask::ExitTask销毁任务。
Reset 通过两种方式更改此方案。 在上面的步骤 5 中,主机调用Reset将任务重置为干净状态,然后将实例与其关联的 IHostTask 实例分离ICLRTask。 如果需要,主机还可以缓存实例以供 IHostTask 重复使用。 在上面的步骤 1 中,运行时从缓存中提取回收 ICLRTask ,而不是创建新实例。
当主机还具有可重用辅助角色任务的池时,此方法非常有效。 当主机销毁其中 IHostTask 一个实例时,它会通过调用销毁相应的 ICLRTask 实例 ExitTask。
要求
平台:请参阅系统要求。
页眉: MSCorEE.h
图书馆: 作为资源包含在 MSCorEE.dll
.NET Framework 版本: 自 2.0 起可用