IDebugProcess2

 

For the latest documentation on Visual Studio 2017, see Visual Studio 2017 Documentation.

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.

IDebugProcess2 : IUnknown  

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.

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.

The following table shows the methods of IDebugProcess2.

MethodDescription
GetInfoGets a description of the process.
EnumProgramsEnumerates the programs that are contained in this process.
GetNameGets the title, friendly name, or file name of the process.
GetServerGets the instance of a machine server this process is running on.
TerminateTerminates the process.
AttachAttaches to the process.
CanDetachDetermines if the SDM can detach the process.
DetachDetaches the debugger from the process.
GetPhysicalProcessIdGets the system process identifier.
GetProcessIdGets 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.]
EnumThreadsEnumerates the threads running in the process.
CauseBreakRequests that the next program running code in this process stop.
GetPortGets the port that this process is running on.

An IDebugProcess2 contains one or more IDebugProgram2 interfaces.

Header: Msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Core Interfaces
GetProcess
LaunchSuspended
GetProcess
Next
Event
IDebugEngineLaunch2
Event
IDebugProgram2

Show: