ICLROnEventManager::RegisterActionOnEvent-Methode

Artikel
08/10/2011

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

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

Parameter

event
[in] Einer der EClrEvent-Werte, die das Ereignis angeben, für das die Registrierung des von pAction beschriebenen Rückrufzeigers erfolgen soll.
pAction
[in] Ein Zeiger auf ein IActionOnCLREvent-Objekt, das aufgerufen wird, wenn das registrierte Ereignis ausgelöst wird.

Rückgabewert

HRESULT	Beschreibungen
S_OK	RegisterActionOnEvent 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 eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Nachdem eine Methode E_FAIL zurückgegeben hat, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

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

Hinweis
Die von RegisterActionOnEvent registrierten Ereignisse können mehrfach und von verschiedenen Threads ausgelöst werden, um ein Entladen oder das Deaktivieren der CLR zu signalisieren.