IDebugPortSupplier2

Artikel
05/16/2015

Stellt anschlüsse dieser Schnittstelle auf die Sitzung debuggen Manager (SDM).

IDebugPortSupplier2 : IUnknown

Hinweise für Implementierer

Ein benutzerdefinierter Port lieferant implementiert diese Schnittstelle, um einen Anschlusslieferanten darzustellen.

Hinweise für Aufrufer

Ein Aufruf von CoCreateInstance mit GUID des Anschlusslieferanten gibt diese Schnittstelle zurück (dies ist die typische Methode zum Abrufen dieser Schnittstelle). Beispiele:

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 IDebugCoreServer2::GetPortSupplier gibt diese Schnittstelle zurück und stellt den aktuellen Anschlusslieferanten dar, der von Visual Studioverwendet wird.

IDebugPort2::GetPortSupplier gibt diese Schnittstelle zurück und stellt den Anschlusslieferanten dar, der den Port erstellt hat.

IEnumDebugPortSuppliers2 stellt eine Liste von IDebugPortSupplier-Schnittstellen dar (die IEnumDebugPortSuppliers-Schnittstelle wird von IDebugCoreServer2::EnumPortSuppliersabgerufen und stellt alle Anschlusslieferanten dar, die mit Visual Studioregistriert sein).

Ein Debuggen Modul in der Regel interagiert nicht mit einem Anschlusslieferanten.

Methoden in die Vtable-Reihenfolge

In der folgenden Tabelle werden die Methoden von IDebugPortSupplier2an.

Methode	Beschreibung
IDebugPortSupplier2::GetPortSupplierName	Ruft den Namen des Anschlusslieferanten ab oder legt diese fest.
IDebugPortSupplier2::GetPortSupplierId	Ruft den Bezeichner des Anschlusslieferanten ab oder legt diese fest.
IDebugPortSupplier2::GetPort	Ruft einen Port aus einem Anschlusslieferanten ab.
IDebugPortSupplier2::EnumPorts	Listet die Anschlüsse, die bereits vorhanden sind.
IDebugPortSupplier2::CanAddPort	Überprüft, ob ein Anschluss lieferant das Hinzufügen neuer Anschlüssen unterstützt.
IDebugPortSupplier2::AddPort	Fügt einen Port hinzufügen.
IDebugPortSupplier2::RemovePort	Entfernt einen Anschluss.

Hinweise

Ein Port lieferant ID und kann anhand des Namens identifizieren, Ports hinzufügen und entfernen und alle Ports auflisten, die der Port lieferant bereitstellt.