IDebugPortSupplier2

This interface supplies ports to the session debug manager (SDM).

IDebugPortSupplier2 : IUnknown

Notes for Implementers

A custom port supplier implements this interface to represent a port supplier.

Notes for Callers

A call to CoCreateInstance with a port supplier's GUID returns this interface (this is the typical way to obtain this interface). For example:

IDebugPortSupplier2 *GetPortSupplier(GUID *pPortSupplierGuid)
{
    IDebugPortSupplier2 *pPS = NULL;
    if (pPortSupplierGuid != NULL) {
        CComPtr<IDebugPortSupplier2> spPortSupplier;
        spPortSupplier.CoCreateInstance(*pPortSupplierGuid);
        if (spPortSupplier != NULL) {
            pPS = spPortSupplier.Detach();
        }
    }
    return (pPS);
}

A call to IDebugCoreServer2::GetPortSupplier returns this interface, representing the current port supplier being used by Visual Studio.

IDebugPort2::GetPortSupplier returns this interface, representing the port supplier that created the port.

IEnumDebugPortSuppliers2 represents a list of IDebugPortSupplier interfaces (the IEnumDebugPortSuppliers interface is obtained from IDebugCoreServer2::EnumPortSuppliers, representing all of the port suppliers registered with Visual Studio).

A debug engine typically does not interact with a port supplier.

Methods in Vtable Order

The following table shows the methods of IDebugPortSupplier2.

Method	Description
IDebugPortSupplier2::GetPortSupplierName	Gets the port supplier name.
IDebugPortSupplier2::GetPortSupplierId	Gets the port supplier identifier.
IDebugPortSupplier2::GetPort	Gets a port from a port supplier.
IDebugPortSupplier2::EnumPorts	Enumerates the ports that already exist.
IDebugPortSupplier2::CanAddPort	Verifies that a port supplier supports adding new ports.
IDebugPortSupplier2::AddPort	Adds a port.
IDebugPortSupplier2::RemovePort	Removes a port.

Remarks

A port supplier can identify itself by name and ID, add and remove ports, and enumerate all ports that the port supplier provides.

Requirements

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See Also

Reference

IDebugPort2::GetPortSupplier

IDebugCoreServer2::GetPortSupplier

IEnumDebugPortSuppliers2

Concepts

Core Interfaces