Compartir a través de

MDAInfo (Estructura)

  • Artículo

Proporciona detalles sobre el evento Event_MDAFired, que desencadena la creación de un asistente de depuración administrada (MDA).

Sintaxis

typedef struct _MDAInfo {  
    LPCWSTR  lpMDACaption;  
    LPCWSTR  lpMDAMessage  
} MDAInfo;

Miembros

Miembro Descripción
lpMDACaption Título del MDA actual. El título describe el tipo de error que ha desencadenado el evento Event_MDAFired.
lpMDAMessage Mensaje de salida que proporciona el MDA actual.

Comentarios

Los asistentes de depuración administrados (MDA) son ayudas a la depuración que funcionan junto con Common Language Runtime (CLR) para realizar tareas tales como identificar condiciones no válidas en el motor de ejecución en tiempo de ejecución o volcar información adicional sobre el estado del motor. Los MDA generan mensajes XML sobre eventos que, de lo contrario, son difíciles de interceptar. Son especialmente útiles para las transiciones de depuración entre código administrado y no administrado.

El runtime realiza los pasos siguientes cuando se activa un evento que desencadena la creación de un MDA:

  • Si el host no ha registrado una instancia de IActionOnCLREvent llamando a ICLROnEventManager::RegisterActionOnEvent para recibir una notificación de un evento Event_MDAFired, el runtime continúa con su comportamiento predeterminado no hospedado.

  • Si el host ha registrado un controlador para este evento, el runtime comprueba si un depurador está asociado al proceso. Si es así, el runtime se interrumpe en el depurador. Cuando el depurador continúa, llama al host. Si no hay ningún depurador asociado, el runtime llama a IActionOnCLREvent::OnEvent y pasa un puntero a una instancia de MDAInfo como parámetro data.

El host puede optar por activar varios MDA y recibir notificaciones cuando se active uno. Esto proporciona al host la oportunidad de invalidar el comportamiento predeterminado y anular el subproceso administrado que ha generado el evento, para evitar que dañe el estado del proceso. Para obtener más información acerca del uso de los MDA, vea Diagnóstico de errores con asistentes para la depuración administrada.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.idl

Biblioteca: incluida como recurso en MSCorEE.dll

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

Consulte también