IDebugProcess3
Note
This article applies to Visual Studio 2015. 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