IActionOnCLREvent::OnEvent 方法
使用對 ICLROnEventManager::RegisterActionOnEvent 方法的呼叫,對已註冊的事件執行回呼。
語法
HRESULT OnEvent (
[in] EClrEvent event,
[in] PVOID data
);
參數
event
[in] 其中一個 EClrEvent 值,表示事件的類型。
data
[in] 物件的指標,其中包含有關 event
的詳細資料。
傳回值
HRESULT | 描述 |
---|---|
S_OK | OnEvent 已成功傳回。 |
HOST_E_CLRNOTAVAILABLE | 通用語言執行平台 (CLR) 尚未載入處理序,或 CLR 處於無法成功執行受控程式碼或處理呼叫的狀態。 |
HOST_E_TIMEOUT | 呼叫逾時。 |
HOST_E_NOT_OWNER | 呼叫端未擁有鎖定。 |
HOST_E_ABANDONED | 封鎖的執行緒或 Fiber 在其上等候時,事件遭到取消。 |
E_FAIL | 發生未知的嚴重失敗。 如果方法傳回 E_FAIL,就無法在處理序中使用 CLR。 後續對任何裝載方法的呼叫會傳回HOST_E_CLRNOTAVAILABLE。 |
備註
data
參數是未指定類型的物件指標。 如果 event
參數為 Event_DomainUnload
, data
則為已卸載之 AppDomain 的數值識別碼。 主機可使用此識別碼作為金鑰,以採取適當的動作。
如果 event
為 Event_MDAFired
, data
則為 MDAInfo 執行個體的指標,其中包含受控偵錯助理 (MDA) 的訊息輸出。 MDA 是 CLR 的一項功能,可協助開發人員進行偵錯,方法是對於解難以理解的事件,產生相關的 XML 訊息。 這類訊息特別適合用於對受控與非受控程式碼間的轉換進行偵錯。 如需詳細資訊,請參閱診斷受控偵錯助理的錯誤。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
程式庫:包含作為 MSCorEE.dll 中的資源
.NET Framework版本:自 2.0 起提供