Megosztás:


IActionOnCLREvent::OnEvent metódus

Visszahívásokat hajt végre az ICLROnEventManager::RegisterActionOnEvent metódus hívásával regisztrált eseményeken.

Szintaxis

HRESULT OnEvent (  
    [in] EClrEvent event,  
    [in] PVOID     data  
);  

Paraméterek

event
[in] Az egyik EClrEvent érték, amely az esemény típusát jelzi.

data
[in] Egy objektumra mutató mutató, amely a fájl eventrészleteit tartalmazza.

Visszatérési érték

HRESULT Description
S_OK OnEvent sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE A közös nyelvi futtatókörnyezet (CLR) nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást.
HOST_E_TIMEOUT A hívás túllépte az időkorlátot.
HOST_E_NOT_OWNER A hívó nem rendelkezik a zárral.
HOST_E_ABANDONED Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várakozott rá.
E_FAIL Ismeretlen katasztrofális hiba történt. Ha egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. Az esetleges üzemeltetési metódusokra irányuló későbbi hívások HOST_E_CLRNOTAVAILABLE adnak vissza.

Megjegyzések

A data paraméter egy meghatározatlan típusú objektumra mutató mutató. Ha a event paraméter a Event_DomainUnload, data a kiürített elem numerikus azonosítója AppDomain . A gazdagép ezt az azonosítót kulcsként használva megfelelő műveletet hajthat végre.

Ha event az Event_MDAFireddata , egy MDAInfo-példányra mutató mutató, amely egy felügyelt hibakeresési segéd (MDA) üzenetkimenetét tartalmazza. Az MDA-k a CLR egyik funkciója, amely segít a fejlesztőknek a hibakeresésben azáltal, hogy XML-üzeneteket hoznak létre az egyébként nehezen alátöltésre nehezedő eseményekről. Az ilyen üzenetek különösen hasznosak lehetnek a felügyelt és a nem felügyelt kód közötti átmenetek hibakeresésében. További információ: Hibák diagnosztizálása felügyelt hibakeresési asszisztensekkel.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta érhető el

Lásd még