Export (0) Print
Expand All

IDebugProcess2

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

The following table shows the methods of IDebugProcess2.

Method

Description

IDebugProcess2::GetInfo

Gets a description of the process.

IDebugProcess2::EnumPrograms

Enumerates the programs that are contained in this process.

IDebugProcess2::GetName

Gets the title, friendly name, or file name of the process.

IDebugProcess2::GetServer

Gets the instance of a machine server this process is running on.

IDebugProcess2::Terminate

Terminates the process.

IDebugProcess2::Attach

Attaches to the process.

IDebugProcess2::CanDetach

Determines if the SDM can detach the process.

IDebugProcess2::Detach

Detaches the debugger from the process.

IDebugProcess2::GetPhysicalProcessId

Gets the system process identifier.

IDebugProcess2::GetProcessId

Gets a globally unique identifier for this process.

IDebugProcess2::GetAttachedSessionName

[DEPRECATED]

Gets the name of the session that is debugging the process.

[DEPRECATED. SHOULD ALWAYS RETURN E_NOTIMPL.]

IDebugProcess2::EnumThreads

Enumerates the threads running in the process.

IDebugProcess2::CauseBreak

Requests that the next program running code in this process stop.

IDebugProcess2::GetPort

Gets 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

Community Additions

ADD
Show:
© 2014 Microsoft