IDebugPort2

This interface represents a debug port on a machine.

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 IDebugPortSupplier2::GetPort or IDebugPortSupplier2::AddPort return this interface, representing the requested port.

Methods in Vtable Order

The following table shows the methods of IDebugPort2.

Method

Description

IDebugPort2::GetPortName

Returns the port name.

IDebugPort2::GetPortId

Returns the port identifier.

IDebugPort2::GetPortRequest

Returns the request used to create a port (if available).

IDebugPort2::GetPortSupplier

Returns the port supplier for this port.

IDebugPort2::GetProcess

Returns an interface to the process given the process's identifier.

IDebugPort2::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, enumerate all processes running on the port, and provide facilities for launching and terminating processes on the port.

Requirements

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See Also

Concepts

Core Interfaces

IDebugPortSupplier2

IDebugCoreServer2