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.
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