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

Concepts

Core Interfaces

Reference

IDebugProcess2

IDebugProgram2