ICLROnEventManager::RegisterActionOnEvent 方法

  • 项目

为指定事件注册回调指针。

语法

HRESULT RegisterActionOnEvent (  
    [in] EClrEvent event,  
    [in] IActionOnCLREvent *pAction  
);

参数

event
[in] 一个 EClrEvent 值，指示要注册 pAction 所描述的回调指针针对的事件。

pAction
[in] 指向 IActionOnCLREvent 对象的指针，当注册的事件激发时，将调用该对象。

返回值

HRESULT 说明
S_OK 已成功返回 RegisterActionOnEvent。
HOST_E_CLRNOTAVAILABLE 公共语言运行时 (CLR) 未加载到进程中，或 CLR 处于无法运行托管代码或无法成功处理调用的状态。
HOST_E_TIMEOUT 调用超时。
HOST_E_NOT_OWNER 调用方未持有锁。
HOST_E_ABANDONED 阻塞的线程或纤程正在等待某一事件，而该事件已被取消。
E_FAIL 发生未知的灾难性故障。 某方法返回 E_FAIL 后，进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。

备注

主机可以为 EClrEvent 描述的两种事件类型中的任一种或两种注册回调。 主机通过调用 ICLRControl::GetCLRManager 方法获取 ICLROnEventManager 接口。

备注

RegisterActionOnEvent 注册的事件可以从不同的线程多次激发，以指示卸载或禁用 CLR。

要求

平台：请参阅系统要求。

标头：MSCorEE.h

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

.NET Framework 版本：自 2.0 起可用

另请参阅