IDebugPortSupplier2

Article
05/17/2015

Les orifices de puissance de cette interface à la session particulière nécessite le gestionnaire (SDM).

IDebugPortSupplier2 : IUnknown

Remarques à l'intention des implémenteurs

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

Remarques pour les appelants

Un appel à CoCreateInstance avec GUID d'un fournisseur de port retourne cette interface (c'est la manière classique pour 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 à IDebugCoreServer2 : : GetPortSupplier retourne cette interface, qui représente le fournisseur actuel de port utilisé par Visual Studio.

IDebugPort2 : : GetPortSupplier retourne cette interface, qui représente le fournisseur de port qui a créé le port.

IEnumDebugPortSuppliers2 représente une liste d'interfaces d' IDebugPortSupplier (l'interface d' IEnumDebugPortSuppliers dérive d' IDebugCoreServer2 : : EnumPortSuppliers, représentant tous les fournisseurs de port enregistrés avec Visual Studio).

Un moteur de débogage en général n'interagissent pas avec un fournisseur de port.

méthodes en commande de Vtable

Le tableau suivant répertorie les méthodes d' IDebugPortSupplier2.

Méthode	Description
IDebugPortSupplier2 : : GetPortSupplierName	obtient le nom de fournisseur de port.
IDebugPortSupplier2 : : GetPortSupplierId	Obtient l'identificateur fournisseur de port.
IDebugPortSupplier2 : : GetPort	obtient un port d'un fournisseur de port.
IDebugPortSupplier2 : : EnumPorts	énumère les ports qui existent déjà.
IDebugPortSupplier2 : : CanAddPort	Vérifie qu'un fournisseur de port prend en charge les nouveaux ports d'addition.
IDebugPortSupplier2 : : AddPort	ajoute un port.
IDebugPortSupplier2 : : RemovePort	Supprime un port.

Notes

Un fournisseur de port peut s'identifient de nom et l'ID, ajouter et supprimer des ports, et énumérer tous les ports que le fournisseur de port fournit.