IDebugEngine2
Note
This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
This interface represents a debug engine (DE). It is used to manage various aspects of a debugging session, from creating breakpoints to setting and clearing exceptions.
Syntax
IDebugEngine2 : IUnknown
Notes for Implementers
This interface is implemented by a custom DE to manage debugging of programs. This interface must be implemented by the DE.
Notes for Callers
This interface is called by the session debug manager (SDM) to manage the debugging session, including managing exceptions, creating breakpoints, and responding to synchronous events sent by the DE.
Methods in Vtable Order
The following table shows the methods of IDebugEngine2.
| Method | Description |
|---|---|
| EnumPrograms | Creates an enumerator for all the programs being debugged by a DE. |
| Attach | Attaches a DE to a program. |
| CreatePendingBreakpoint | Creates a pending breakpoint in the DE. |
| SetException | Specifies how the DE should handle a given exception. |
| RemoveSetException | Removes the specified exception so it is no longer handled by the debug engine. |
| RemoveAllSetExceptions | Removes the list of exceptions the IDE has set for a particular run-time architecture or language. |
| GetEngineID | Gets the GUID of the DE. |
| DestroyProgram | Informs a DE that the program specified has been atypically terminated and that the DE should clean up all references to the program and send a program destroy event. |
| ContinueFromSynchronousEvent | Called by the SDM to indicate that a synchronous debug event, previously sent by the DE to the SDM, was received and processed. |
| SetLocale | Sets the locale of the DE. |
| SetRegistryRoot | Sets the registry root currently in use by the DE. |
| SetMetric | Sets a metric. |
| CauseBreak | Requests that all programs being debugged by this DE stop execution the next time one of their threads attempts to run. |
Requirements
Header: Msdbg.h
Namespace: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll