IActionOnCLREvent::OnEvent (Método)
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
