IDebugPortSupplier2

  • Artikel

Diese Schnittstelle stellt Ports für den Sitzungsdebug-Manager (SDM) bereit.

Syntax

IDebugPortSupplier2 : IUnknown

Hinweise für Implementierer

Ein benutzerdefinierter Portanbieter implementiert diese Schnittstelle, um einen Portlieferanten darzustellen.

Hinweise für Aufrufer

Ein Aufruf CoCreateInstance mit dem Portanbieter GUID gibt diese Schnittstelle zurück (dies ist die typische Methode zum Abrufen dieser Schnittstelle). Beispiel:

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

Ein Aufruf von GetPortSupplier gibt diese Schnittstelle zurück, die den aktuellen Portanbieter darstellt, der von Visual Studio verwendet wird.

  • GetPortSupplier gibt diese Schnittstelle zurück, die den Portanbieter darstellt, der den Port erstellt hat.

  • IEnumDebugPortSuppliers2 stellt eine Liste der IDebugPortSupplier Schnittstellen dar (die IEnumDebugPortSuppliers Schnittstelle wird von EnumPortSuppliers abgerufen, die alle portlieferanten darstellt, die bei Visual Studio registriert sind).

Ein Debugmodul interagiert in der Regel nicht mit einem Portanbieter.

Methoden in Vtable-Reihenfolge

In der folgenden Tabelle sind die Methoden von IDebugPortSupplier2 aufgeführt.

Methode Beschreibung
GetPortSupplierName Ruft den Namen des Portanbieters ab.
GetPortSupplierId Ruft den Port-Lieferantenbezeichner ab.
GetPort Ruft einen Port von einem Portanbieter ab.
EnumPorts Listet die bereits vorhandenen Ports auf.
CanAddPort Überprüft, ob ein Portanbieter das Hinzufügen neuer Ports unterstützt.
AddPort Fügt einen Port hinzu.
RemovePort Entfernt einen Port.

Hinweise

Ein Portanbieter kann sich anhand des Namens und der ID identifizieren, Ports hinzufügen und entfernen und alle vom Portanbieter bereitgestellten Ports aufzählen.

Anforderungen

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Siehe auch