IActionOnCLREvent::OnEvent-Methode

Artikel
08/10/2011

Führt Rückrufe für Ereignisse durch, die durch einen Aufruf der ICLROnEventManager::RegisterActionOnEvent-Methode registriert wurden.

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

Parameter

event
[in] Einer der EClrEvent-Werte, die den Ereignistyp angeben.
data
[in] Ein Zeiger auf ein Objekt, das Details über event enthält.

Rückgabewert

HRESULT	Beschreibungen
S_OK	OnEvent erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder ein blockierter Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe einer beliebigen Hostmethode geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

Der data-Parameter ist ein Zeiger auf ein Objekt ohne Typangabe. Wenn der event-Parameter Event_DomainUnload lautet, ist data der numerische Bezeichner für die entladene AppDomain. Der Host kann eine entsprechende Aktion mit diesem Bezeichner als Schlüssel ausführen.

Wenn event Event_MDAFired lautet, ist data ein Zeiger auf eine MDAInfo-Instanz, die die Meldungsausgabe eines Assistenten für verwaltetes Debuggen (Managed Debugging Assistant, MDA) enthält. MDAs sind ein Feature der CLR, die Entwickler beim Debuggen unterstützen, indem sie XML-Meldungen über Ereignisse generieren, die andernfalls schwer aufzufangen wären. Solche Meldungen können beim Debuggen von Übergängen zwischen verwaltetem und nicht verwaltetem Code besonders nützlich sein. Weitere Informationen finden Sie unter Diagnostizieren von Fehlern mit Assistenten für verwaltetes Debuggen.