Methode iActionOnCLREvent::OnEvent
Voert callbacks uit op gebeurtenissen die zijn geregistreerd met behulp van een aanroep naar de methode ICLROnEventManager::RegisterActionOnEvent .
Syntaxis
HRESULT OnEvent (
[in] EClrEvent event,
[in] PVOID data
);
Parameters
event
[in] Een van de EClrEvent-waarden , die het type gebeurtenis aangeeft.
data
[in] Een aanwijzer naar een object dat details over eventbevat.
Retourwaarde
| HRESULT | Beschrijving |
|---|---|
| S_OK | OnEvent is geretourneerd. |
| HOST_E_CLRNOTAVAILABLE | De Common Language Runtime (CLR) is niet geladen in een proces of de CLR bevindt zich in een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt. |
| HOST_E_TIMEOUT | Er is een time-out opgetreden voor het gesprek. |
| HOST_E_NOT_OWNER | De beller is niet de eigenaar van het vergrendelingsslot. |
| HOST_E_ABANDONED | Een gebeurtenis is geannuleerd terwijl een geblokkeerde thread of glasvezel erop wachtte. |
| E_FAIL | Er is een onbekende catastrofale fout opgetreden. Als een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar een hostingmethode retourneren HOST_E_CLRNOTAVAILABLE. |
Opmerkingen
De data parameter is een verwijzing naar een object van het niet-opgegeven type. Als de event parameter is Event_DomainUnload, data is de numerieke id voor de AppDomain die is uitgeladen. De host kan de juiste actie ondernemen met behulp van deze id als sleutel.
Als event is Event_MDAFired, data is een verwijzing naar een MDAInfo-exemplaar dat de berichtuitvoer van een Managed Debugging Assistant (MDA) bevat. MDA's zijn een functie van de CLR die ontwikkelaars helpt bij foutopsporing, door XML-berichten te genereren over gebeurtenissen die anders moeilijk te vangen zijn. Dergelijke berichten kunnen met name handig zijn bij het opsporen van fouten in overgangen tussen beheerde en onbeheerde code. Zie Diagnose van fouten met beheerde foutopsporingsassistenten voor meer informatie.
Vereisten
Platforms: Zie Systeemvereisten.
Header: MSCorEE.h
Bibliotheek: Opgenomen als een resource in MSCorEE.dll
.NET Framework versies: beschikbaar sinds 2.0
