IDebugProcess3

This interface represents a running process and its programs. This interface exists as a replacement to several methods in the IDebugProgram2 interface. It provides control over all programs in the process.

Note

IDebugProgram2::Continue, IDebugProgram2::Execute, and IDebugProgram2::Step methods are deprecated and should no longer be used. Use the corresponding methods on the IDebugProcess3 interface instead.

IDebugProcess3 : IDebugProcess2

Notes for Implementers

This interface is implemented by a custom port supplier to manage programs as a group. When programs are managed as a group, you can control their execution and establish a language for an expression evaluator. This interface must be implemented by the port supplier.

Notes for Callers

This interface is called primarily by the session debug manager (SDM) in order to interact with a group of programs identified in this process.

Call QueryInterface on an IDebugProcess2 interface to obtain this interface.

Methods in Vtable Order

In addition to the methods inherited from IDebugProcess2, IDebugProcess3 implements the following methods.

Method	Description
IDebugProcess3::Continue	Continues execution of or stepping through a process.
IDebugProcess3::Execute	Begins execution of a process.
IDebugProcess3::Step	Steps forward one instruction or statement in the process.
IDebugProcess3::GetDebugReason	Gets the reason that the process was launched for debugging.
IDebugProcess3::SetHostingProcessLanguage	Sets the hosting language so that the debug engine can load the appropriate expression evaluator.
IDebugProcess3::GetHostingProcessLanguage	Retrieves the language currently set for this process.
IDebugProcess3::DisableENC	Disables Edit and Continue (ENC) for this process. A custom port supplier does not implement this method (it should always return E_NOTIMPL).
IDebugProcess3::GetENCAvailableState	Get the ENC state for this process. A custom port supplier does not implement this method (it should always return E_NOTIMPL).
IDebugProcess3::GetEngineFilter	Retrieves an array of unique identifiers for available debug engines.

Requirements

Header: Msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See Also

Reference

IDebugProcess2

IDebugProgram2

Concepts

Core Interfaces