IDebugPort2

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 represents a debug port on a machine.

Syntax

IDebugPort2 : IUnknown

Notes for Implementers

A custom port supplier implements this interface to represent a debug port on a machine.

If the port supports sending port events, it must also implement the IConnectionPointContainer interface to support an IConnectionPoint interface that in turn provides the IDebugPortEvents2 interface.

Notes for Callers

Calls to GetPort or AddPort return this interface, representing the requested port.

Methods in Vtable Order

The following table shows the methods of IDebugPort2.

Method Description
GetPortName Returns the port name.
GetPortId Returns the port identifier.
GetPortRequest Returns the request used to create a port (if available).
GetPortSupplier Returns the port supplier for this port.
GetProcess Returns an interface to the process given the process's identifier.
EnumProcesses Enumerates all the processes running on a port.

Remarks

The local port provides access to all the processes and programs running on the local machine. Other ports might represent a serial cable connection to a Windows CE-based device, or a network connection to a non-DCOM computer. The IDebugPort2 interface is used to find the name and identifier of a port, and enumerate all processes running on the port. Facilities for launching and terminating processes on the port are implemented in the IDebugPortEx2 interface.

Requirements

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See also