IDebugEngine2
Esta interfaz representa un motor de depuración (DE). Se usa para administrar varios aspectos de una sesión de depuración, desde la creación de puntos de interrupción para establecer y borrar excepciones.
Sintaxis
IDebugEngine2 : IUnknown
Notas para los implementadores
Esta interfaz se implementa mediante un DE personalizado para administrar la depuración de programas. El DE debe implementar esta interfaz.
Notas para autores de la llamada
El administrador de depuración de sesión (SDM) llama a esta interfaz para administrar la sesión de depuración, incluida la administración de excepciones, la creación de puntos de interrupción y la respuesta a eventos sincrónicos enviados por el DE.
Métodos en orden de Vtable
En la tabla siguiente se muestran los métodos de IDebugEngine2.
| Método | Descripción |
|---|---|
| EnumPrograms | Crea un enumerador para todos los programas que depura un DE. |
| Adjuntar | Adjunta un DE a un programa. |
| CreatePendingBreakpoint | Crea un punto de interrupción pendiente en el DE. |
| SetException | Especifica cómo el DE debe controlar una excepción determinada. |
| RemoveSetException | Quita la excepción especificada para que el motor de depuración ya no lo controle. |
| RemoveAllSetExceptions | Quita la lista de excepciones que el IDE ha establecido para una arquitectura o lenguaje en tiempo de ejecución determinado. |
| GetEngineID | Obtiene el GUID del DE. |
| DestroyProgram | Informa a un DE de que el programa especificado se ha terminado normalmente y que el DE debe limpiar todas las referencias al programa y enviar un evento de destrucción de programa. |
| ContinueFromSynchronousEvent | Lo llama el SDM para indicar que se recibió y procesó un evento de depuración sincrónico, enviado previamente por el DE al SDM. |
| SetLocale | Establece la configuración regional del DE. |
| SetRegistryRoot | Establece la raíz del Registro actualmente en uso por parte del DE. |
| SetMetric | Establece una métrica. |
| CauseBreak | Solicita que todos los programas que depura esta DE detengan la ejecución la próxima vez que uno de sus subprocesos intente ejecutarse. |
Requisitos
Encabezado: Msdbg.h
Espacio de nombres: Microsoft.VisualStudio.Debugger.Interop
Ensamblado: Microsoft.VisualStudio.Debugger.Interop.dll