Methode ICLROnEventManager::RegisterActionOnEvent
Registreert een callback-aanwijzer voor de opgegeven gebeurtenis.
Syntaxis
HRESULT RegisterActionOnEvent (
[in] EClrEvent event,
[in] IActionOnCLREvent *pAction
);
Parameters
event
[in] Een van de EClrEvent-waarden , die de gebeurtenis aangeeft waarvoor de callback-aanwijzer moet worden geregistreerd die wordt beschreven door pAction
.
pAction
[in] Een aanwijzer naar een IActionOnCLREvent-object dat wordt aangeroepen wanneer de geregistreerde gebeurtenis wordt geactiveerd.
Retourwaarde
HRESULT | Beschrijving |
---|---|
S_OK | RegisterActionOnEvent is geretourneerd. |
HOST_E_CLRNOTAVAILABLE | De COMMON Language Runtime (CLR) is niet geladen in een proces of de CLR heeft 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 slot. |
HOST_E_ABANDONED | Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte. |
E_FAIL | Er is een onbekende catastrofale fout opgetreden. Nadat een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE. |
Opmerkingen
De host kan callbacks registreren voor een of beide van de twee gebeurtenistypen die worden beschreven door EClrEvent
. De host haalt de ICLROnEventManager
interface op door de methode ICLRControl::GetCLRManager aan te roepen.
Notitie
De gebeurtenissen die RegisterActionOnEvent
worden geregistreerd, kunnen meer dan één keer worden geactiveerd en vanuit verschillende threads om een uitlading of het uitschakelen van de CLR aan te geven.
Vereisten
Platforms: Zie Systeemvereisten.
Header: MSCorEE.h
Bibliotheek: Opgenomen als een resource in MSCorEE.dll
.NET Framework versies: beschikbaar sinds 2.0