IDebugPortEx2

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. 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 lets the session debug manager (SDM) control the programs and processes running on a port.

Syntax

IDebugPortEx2 : IUnknown

Notes for Implementers

A custom port supplier implements this interface on the same object that implements IDebugPort2.

Notes for Callers

The SDM calls QueryInterface on the IDebugPort2 interface to obtain this interface.

Methods in Vtable Order

The following table shows the methods of IDebugPortEx2.

Method Description
LaunchSuspended Launches an executable file.
ResumeProcess Resumes execution of a process.
CanTerminateProcess Determines whether a process can be terminated.
TerminateProcess Terminates a process.
GetPortProcessId Gets the process ID of the port itself.
GetProgram Gets a program associated with a program node.

Remarks

This interface is normally private between the SDM and the custom port supplier.

If desired, a debug engine (DE) can look for this interface on the IDebugPort2 interface passed to LaunchSuspended and use LaunchSuspended to launch the program. This is not a requirement, however, and a DE can do whatever it needs to do to launch the request program.

Requirements

Header: portpriv.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See also