IHostTask::Alert 方法

更新:2007 年 11 月

请求宿主唤醒由当前 IHostTask 实例表示的任务,这样,就可以中止该任务。

HRESULT Alert ();

返回值

HRESULT

说明

S_OK

该方法已成功返回。

HOST_E_CLRNOTAVAILABLE

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

HOST_E_TIMEOUT

调用超时。

HOST_E_NOT_OWNER

调用方不拥有锁。

HOST_E_ABANDONED

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

E_FAIL

发生了未知的灾难性故障。如果某方法返回 E_FAIL,CLR 便无法再在进程中使用。对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。

备注

CLR 在从用户模式调用 Thread.Abort 时,或在与当前 Thread 关联的 AppDomain 关闭时调用 Alert 方法。宿主必须立即返回,因为该调用是异步进行的。如果宿主不能立即向该任务发出警报,则必须在该任务下一次进入可接受警报的状态时唤醒它。

说明:

Alert 只影响运行库已向诸如 Join 之类的方法传递了 WAIT_OPTION 值 WAIT_ALERTABLE 的那些任务。

要求

**平台:**请参见 .NET Framework 系统要求

**头文件:**MSCorEE.idl

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

**.NET Framework 版本:**3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

请参见

参考

ICLRTask

ICLRTaskManager

IHostTask

IHostTaskManager