ICLROnEventManager::RegisterActionOnEvent (Método)

Artículo
08/10/2011

Registra un puntero de devolución de llamada para el evento especificado.

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

Parámetros

event
[in] Uno de los valores de EClrEvent, que indica el evento para el que se va a registrar el puntero de devolución de llamada descrito por pAction.
pAction
[in] Puntero a un objeto IActionOnCLREvent al que se llama cuando se provoca el evento registrado.

Valor devuelto

HRESULT	Descripción
S_OK	RegisterActionOnEvent finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Cuando un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Comentarios

El host puede registrar las devoluciones de llamada para uno de los dos tipos de evento descritos por EClrEvent, o para los dos. El host obtiene la interfaz ICLROnEventManager llamando al método ICLRControl::GetCLRManager.

Nota
Los eventos que registra RegisterActionOnEvent pueden provocarse varias veces desde subprocesos diferentes para indicar una descarga o la deshabilitación de CLR.