IDebugExceptionEvent2
El motor de depuración (DE) envía esta interfaz al administrador de depuración de sesión (SDM) cuando se produce una excepción en el programa que se está ejecutando actualmente.
Sintaxis
IDebugExceptionEvent2 : IUnknown
Notas para los implementadores
El DE implementa esta interfaz para informar de que se ha producido una excepción en el programa que se está depurando. La interfaz IDebugEvent2 debe implementarse en el mismo objeto que esta interfaz. SdM usa QueryInterface para acceder a la IDebugEvent2 interfaz.
Notas para autores de la llamada
El DE crea y envía este objeto de evento para notificar una excepción. El evento se envía mediante la función de devolución de llamada IDebugEventCallback2 proporcionada por el SDM cuando se adjunta al programa que se está depurando.
Métodos en orden de Vtable
En la tabla siguiente se muestran los métodos de IDebugExceptionEvent2.
| Método | Descripción |
|---|---|
| GetException | Obtiene información detallada sobre la excepción que desencadenó este evento. |
| GetExceptionDescription | Obtiene una descripción legible para la excepción producida que desencadenó este evento. |
| CanPassToDebuggee | Determina si el motor de depuración (DE) admite o no la opción de pasar esta excepción al programa que se está depurando cuando se reanuda la ejecución. |
| PassToDebuggee | Especifica si la excepción se debe pasar al programa que se está depurando cuando se reanuda la ejecución o si se debe descartar la excepción. |
Requisitos
Encabezado: msdbg.h
Espacio de nombres: Microsoft.VisualStudio.Debugger.Interop
Ensamblado: Microsoft.VisualStudio.Debugger.Interop.dll
Comentarios
Antes de enviar el evento, el DE comprueba si este evento de excepción se ha designado una excepción de primera oportunidad o segunda oportunidad mediante una llamada anterior a SetException. Si se ha designado para ser una excepción de primera oportunidad, el IDebugExceptionEvent2 evento se envía al SDM. Si no es así, el DE ofrece a la aplicación la oportunidad de controlar la excepción. Si no se proporciona ningún controlador de excepciones y si la excepción se ha designado como una excepción de segunda oportunidad, el IDebugExceptionEvent2 evento se envía al SDM. De lo contrario, el DE reanuda la ejecución del programa y el sistema operativo o el tiempo de ejecución controla la excepción.