IDebugPortSupplier2

Article
01/12/2024

Cette interface fournit des ports au gestionnaire de débogage de session (SDM).

Syntaxe

IDebugPortSupplier2 : IUnknown

Remarques pour les implémenteurs

Un fournisseur de ports personnalisé implémente cette interface pour représenter un fournisseur de ports.

Remarques pour les appelants

Un appel à CoCreateInstance l’aide d’un fournisseur de GUID ports retourne cette interface (il s’agit de la façon classique d’obtenir cette interface). Par exemple :

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

Un appel à GetPortSupplier retourne cette interface, représentant le fournisseur de ports actuel utilisé par Visual Studio.

GetPortSupplier retourne cette interface, représentant le fournisseur de ports qui a créé le port.
IEnumDebugPortSuppliers2 représente une liste d’interfaces IDebugPortSupplier (l’interface IEnumDebugPortSuppliers est obtenue à partir d’EnumPortSuppliers, représentant tous les fournisseurs de ports inscrits auprès de Visual Studio).

Un moteur de débogage n’interagit généralement pas avec un fournisseur de ports.

Méthodes dans l'ordre Vtable

Le tableau suivant présente les méthodes de IDebugPortSupplier2.

Méthode	Description
GetPortSupplierName	Obtient le nom du fournisseur de ports.
GetPortSupplierId	Obtient l’identificateur du fournisseur de ports.
GetPort	Obtient un port d’un fournisseur de ports.
EnumPorts	Énumère les ports qui existent déjà.
CanAddPort	Vérifie qu’un fournisseur de ports prend en charge l’ajout de nouveaux ports.
AddPort	Ajoute un port.
RemovePort	Supprime un port.

Notes

Un fournisseur de ports peut s’identifier par nom et ID, ajouter et supprimer des ports et énumérer tous les ports que le fournisseur de ports fournit.

Spécifications

En-tête : msdbg.h

Espace de noms : Microsoft.VisualStudio.Debugger.Interop

Assembly : Microsoft.VisualStudio.Debugger.Interop.dll

Partager via