Condividi tramite


IDebugEngine2

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.

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

IDebugEngine2::EnumPrograms

Creates an enumerator for all the programs being debugged by a DE.

IDebugEngine2::Attach

Attaches a DE to a program.

IDebugEngine2::CreatePendingBreakpoint

Creates a pending breakpoint in the DE.

IDebugEngine2::SetException

Specifies how the DE should handle a given exception.

IDebugEngine2::RemoveSetException

Removes the specified exception so it is no longer handled by the debug engine.

IDebugEngine2::RemoveAllSetExceptions

Removes the list of exceptions the IDE has set for a particular run-time architecture or language.

IDebugEngine2::GetEngineID

Gets the GUID of the DE.

IDebugEngine2::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.

IDebugEngine2::ContinueFromSynchronousEvent

Called by the SDM to indicate that a synchronous debug event, previously sent by the DE to the SDM, was received and processed.

IDebugEngine2::SetLocale

Sets the locale of the DE.

IDebugEngine2::SetRegistryRoot

Sets the registry root currently in use by the DE.

IDebugEngine2::SetMetric

Sets a metric.

IDebugEngine2::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

See Also

Reference

IDebugEventCallback2::Event

IDebugEngineCreateEvent2::GetEngine