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	封鎖的執行緒或 Fiber 在其上等候時，事件遭到取消。
E_FAIL	發生未知的嚴重失敗。方法傳回 E_FAIL 之後，就無法在處理序中使用 CLR。後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。

主機可以針對EClrEvent所描述的兩種事件類型，或兩者註冊回撥。主機藉由呼叫 ICLRControl::GetCLRManager 方法來取得 ICLROnEventManager 介面。

注意

RegisterActionOnEvent 註冊的事件可以多次引發，並從不同的執行緒發出信號，以發出卸載或停用 CLR 的訊號。

平台：請參閱系統需求。

標題： MSCorEE.h

程式庫：包含作為 MSCorEE.dll 中的資源

.NET Framework版本：自 2.0 起可用