IDebugEngine3

  • Article

Represents a single debug engine (DE) that controls the debugging of one or more modules.

IDebugEngine3 : IDebugEngine2

Notes for Implementers

This interface is implemented by a custom DE (if it supports symbols) to enable the JustMyCode state. This interface must be implemented by the DE if it supports symbols and JustMyCode.

Notes for Callers

This interface is called by the session debug manager (SDM) to pass on user options for locations from which to load symbols. It is also called to set the GUID of the engine when it is instantiated (this GUID is based on the metrics from the time of engine registration). The SDM also calls this interface to set the JustMyCode state and to set all exceptions known by the debugger to a specified state.

Methods in Vtable Order

In addition to the methods inherited from IDebugEngine2, the IDebugEngine3 interface exposes the following methods.

Method

Description

IDebugEngine3::SetSymbolPath

Sets the path or paths that the DE will use to search for debugging symbols.

IDebugEngine3::LoadSymbols

Loads the symbols for all modules that have not yet had their symbols loaded.

IDebugEngine3::SetJustMyCodeState

Tells the DE about the JustMyCode information.

IDebugEngine3::SetEngineGuid

Sets the DE GUID from the metrics.

IDebugEngine3::SetAllExceptions

Set all exceptions currently outstanding to a specified state.

Requirements

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See Also

Reference

IDebugEngine2