Freigeben über

ICLROnEventManager::RegisterActionOnEvent-Methode

  • Artikel

Registriert einen Rückrufzeiger für das angegebene Ereignis.

Syntax

HRESULT RegisterActionOnEvent (  
    [in] EClrEvent event,  
    [in] IActionOnCLREvent *pAction  
);

Parameter

event
[in] Einer der EClrEvent-Werte, der das Ereignis angibt, für das der von pAction beschriebene Rückrufzeiger registriert werden soll.

pAction
[in] Ein Zeiger auf ein IActionOnCLREvent-Objekt, das aufgerufen wird, wenn das registrierte Ereignis ausgelöst wird.

Rückgabewert

HRESULT BESCHREIBUNG
S_OK RegisterActionOnEvent wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann.
HOST_E_TIMEOUT Timeout des Aufrufs.
HOST_E_NOT_OWNER Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat.
E_FAIL Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode „E_FAIL“ zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Bemerkungen

Der Host kann Rückrufe für einen oder beide der zwei von EClrEvent beschriebenen Ereignistypen registrieren. Der Host ruft die ICLROnEventManager-Schnittstelle ab, indem er die ICLRControl::GetCLRManager-Methode aufruft.

Hinweis

Die von RegisterActionOnEvent registrierten Ereignisse können mehrmals und aus verschiedenen Threads ausgelöst werden, um ein Entladen oder deaktivieren der CLR zu signalisieren.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch