IDebugProcess2

Article
11/15/2016

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 process running on a port. If the port is the local port, then IDebugProcess2 usually represents a physical process on the local machine.

Syntax

IDebugProcess2 : IUnknown

Notes for Implementers

This interface is implemented by a custom port supplier to manage programs as a group. This interface must be implemented by the port supplier.

A debug engine also implements this interface if it supports launching a program through LaunchSuspended.

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 GetProcess or GetProcess to get this interface. This interface is also returned by calling IDebugEngineLaunch2::LaunchSuspended.

Methods in Vtable Order

The following table shows the methods of IDebugProcess2.

Method	Description
GetInfo	Gets a description of the process.
EnumPrograms	Enumerates the programs that are contained in this process.
GetName	Gets the title, friendly name, or file name of the process.
GetServer	Gets the instance of a machine server this process is running on.
Terminate	Terminates the process.
Attach	Attaches to the process.
CanDetach	Determines if the SDM can detach the process.
Detach	Detaches the debugger from the process.
GetPhysicalProcessId	Gets the system process identifier.
GetProcessId	Gets a globally unique identifier for this process.
GetAttachedSessionName [DEPRECATED]	Gets the name of the session that is debugging the process. [DEPRECATED. SHOULD ALWAYS RETURN `E_NOTIMPL`.]
EnumThreads	Enumerates the threads running in the process.
CauseBreak	Requests that the next program running code in this process stop.
GetPort	Gets the port that this process is running on.

Remarks

An IDebugProcess2 contains one or more IDebugProgram2 interfaces.

Requirements

Header: Msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll