共用方式為

ICLROnEventManager::RegisterActionOnEvent 方法

  • 發行項

註冊指定之事件的回呼指標。

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

參數

  • event
    [in] 其中一個 EClrEvent 值，表示要註冊 pAction 所描述之回呼指標的事件。

  • pAction
    [in] 引發註冊的事件時，所呼叫之 IActionOnCLREvent 物件的指標。

傳回值

HRESULT

描述

S_OK

RegisterActionOnEvent 已成功傳回。

HOST_E_CLRNOTAVAILABLE

Common Language Runtime (CLR) 尚未載入至處理序中，或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。

HOST_E_TIMEOUT

呼叫已逾時。

HOST_E_NOT_OWNER

呼叫端不具備鎖定功能。

HOST_E_ABANDONED

已封鎖執行緒或 Fiber 在等候事件時，該事件已遭取消。

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 介面