Compartir a través de

IActionOnCLREvent::OnEvent (Método)

  • Artículo

Realiza devoluciones de llamada en eventos registrados mediante una llamada al método ICLROnEventManager::RegisterActionOnEvent.

Sintaxis

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

Parámetros

event
[in] Uno de los valores 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 se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar 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 autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Si se devuelve este valor, significa que se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Si se devuelve este valor, significa que ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el motor CLR ya no se podrá usar en el proceso. Las llamadas posteriores 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 del elemento AppDomain que se descargó. El host puede realizar las acciones adecuadas con este identificador como clave.

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

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también