IDebugProcess3

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. 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 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

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

Syntax

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
Continue Continues execution of or stepping through a process.
Execute Begins execution of a process.
Step Steps forward one instruction or statement in the process.
GetDebugReason Gets the reason that the process was launched for debugging.
SetHostingProcessLanguage Sets the hosting language so that the debug engine can load the appropriate expression evaluator.
GetHostingProcessLanguage Retrieves the language currently set for this process.
DisableENC Disables Edit and Continue (ENC) for this process.

A custom port supplier does not implement this method (it should always return E_NOTIMPL).
GetENCAvailableState Get the ENC state for this process.

A custom port supplier does not implement this method (it should always return E_NOTIMPL).
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