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) 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。
HOST_E_TIMEOUT	调用超时。
HOST_E_NOT_OWNER	调用方不拥有锁。
HOST_E_ABANDONED	事件在被阻止的线程或纤程正在等待它时被取消。
E_FAIL	发生了未知的灾难性故障。 在某方法返回 E_FAIL 后，CLR 便无法再在进程中使用。 对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。

备注

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

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

要求

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

**头文件：**MSCorEE.h

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

**.NET Framework 版本：**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

请参见

参考

EClrEvent 枚举

IActionOnCLREvent 接口

ICLRControl 接口

ICLROnEventManager 接口