通过


ICLRTask::Reset 方法

通知公共语言运行时(CLR)主机已完成任务,并使 CLR 能够重复使用当前的 ICLRTask 实例来表示另一个任务。

Syntax

HRESULT Reset (
    [in] BOOL fFull
);

参数

fFull [in] true如果运行时除了与当前 ICLRTask 实例相关的安全和区域设置信息外,还应重置所有与线程相关的静态值;否则为 false

如果值为, true运行时将重置使用 AllocateDataSlotAllocateNamedDataSlot存储的数据。

返回值

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 正常生命周期:

  1. 运行时创建一个新 ICLRTask 实例。

  2. 运行时调用 IHostTaskManager::GetCurrentTask 以获取对当前主机任务的引用。

  3. 运行时调用 IHostTask::SetCLRTask 以将新实例与主机任务相关联。

  4. 任务执行并完成。

  5. 主机通过调用 ICLRTask::ExitTask销毁任务。

Reset 通过两种方式更改此方案。 在上面的步骤 5 中,主机调用Reset将任务重置为干净状态,然后将实例与其关联的 IHostTask 实例分离ICLRTask。 如果需要,主机还可以缓存实例以供 IHostTask 重复使用。 在上面的步骤 1 中,运行时从缓存中提取回收 ICLRTask ,而不是创建新实例。

当主机还具有可重用辅助角色任务的池时,此方法非常有效。 当主机销毁其中 IHostTask 一个实例时,它会通过调用销毁相应的 ICLRTask 实例 ExitTask

要求

平台:请参阅系统要求

页眉: MSCorEE.h

图书馆: 作为资源包含在 MSCorEE.dll

.NET Framework 版本: 自 2.0 起可用

另见