IDebugPortSupplier2

Articolo
01/12/2024

Questa interfaccia fornisce le porte al gestore di debug della sessione (SDM).

Sintassi

IDebugPortSupplier2 : IUnknown

Note per gli implementatori

Un fornitore di porte personalizzato implementa questa interfaccia per rappresentare un fornitore di porte.

Note per i chiamanti

Una chiamata a CoCreateInstance con un fornitore di GUID porte restituisce questa interfaccia (questo è il modo tipico per ottenere questa interfaccia). Ad esempio:

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

Una chiamata a GetPortSupplier restituisce questa interfaccia, che rappresenta il fornitore di porte corrente utilizzato da Visual Studio.

GetPortSupplier restituisce questa interfaccia, che rappresenta il fornitore di porte che ha creato la porta.
IEnumDebugPortSuppliers2 rappresenta un elenco di IDebugPortSupplier interfacce (l'interfaccia IEnumDebugPortSuppliers viene ottenuta da EnumPortSuppliers, che rappresenta tutti i fornitori di porte registrati con Visual Studio).

Un motore di debug in genere non interagisce con un fornitore di porte.

Metodi nell'ordine Vtable

Nella tabella seguente vengono illustrati i metodi di IDebugPortSupplier2.

metodo	Descrizione
GetPortSupplierName	Ottiene il nome del fornitore di porte.
GetPortSupplierId	Ottiene l'identificatore del fornitore di porte.
GetPort	Ottiene una porta da un fornitore di porte.
EnumPorts	Enumera le porte già esistenti.
CanAddPort	Verifica che un fornitore di porte supporti l'aggiunta di nuove porte.
AddPort	Aggiunge una porta.
RemovePort	Rimuove una porta.

Osservazioni:

Un fornitore di porte può identificarsi in base al nome e all'ID, aggiungere e rimuovere porte ed enumerare tutte le porte fornite dal fornitore di porte.

Requisiti

Intestazione: msdbg.h

Spazio dei nomi: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Condividi tramite