IActionOnCLREvent::OnEvent (Método)

Artículo
08/10/2011

Realiza devoluciones de llamada en eventos que se han registrado mediante una llamada al método ICLROnEventManager::RegisterActionOnEvent.

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

Parámetros

event
[in] Uno de los valores de EClrEvent, que indica el tipo de evento.
data
[in] Puntero a un objeto que contiene detalles sobre event.

Valor devuelto

HRESULT	Descripción
S_OK	OnEvent 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. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a cualquier método de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Comentarios

El parámetro data es un puntero a un objeto de tipo no especificado. Si el parámetro event es Event_DomainUnload, data es el identificador numérico para el objeto AppDomain que se ha descargado. El host puede realizar las acciones apropiadas utilizando este identificador como clave.

Si event es Event_MDAFired, data es un puntero a una instancia de MDAInfo que contiene los mensajes de salida de un Asistente para depuración administrada (MDA). Los MDA son una característica de CLR que ayuda a los desarrolladores en la depuración, generando mensajes XML sobre eventos que de otra forma resultarían difíciles de interceptar. Estos mensajes pueden ser especialmente útiles para depurar las transiciones entre el código administrado y el no administrado. Para obtener más información, vea Diagnóstico de errores con ayudantes de depuraciones administradas.