IDebugPortSupplier2

Artigo
01/12/2024

Essa interface fornece portas para o gerenciador de depuração de sessão (SDM).

Sintaxe

IDebugPortSupplier2 : IUnknown

Notas para implementadores

Um fornecedor de porta personalizado implementa essa interface para representar um fornecedor portuário.

Observações para chamadores

Uma chamada para CoCreateInstance com um fornecedor portuário GUID retorna essa interface (essa é a maneira típica de obter essa interface). Por exemplo:

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

Uma chamada para GetPortSupplier retorna essa interface, representando o fornecedor de porta atual que está sendo usado pelo Visual Studio.

GetPortSupplier retorna essa interface, representando o fornecedor de porta que criou a porta.
IEnumDebugPortSuppliers2 representa uma lista de interfaces (a IEnumDebugPortSuppliers interface é obtida de EnumPortSuppliers, representando todos os fornecedores de IDebugPortSupplier porta registrados no Visual Studio).

Um mecanismo de depuração normalmente não interage com um fornecedor de porta.

Métodos na ordem VTable

A tabela a seguir mostra os métodos de IDebugPortSupplier2.

Método	Descrição
GetPortSupplierName	Obtém o nome do fornecedor da porta.
GetPortSupplierId	Obtém o identificador do fornecedor da porta.
GetPort	Obtém uma porta de um fornecedor portuário.
EnumPorts	Enumera as portas que já existem.
CanAddPort	Verifica se um fornecedor de porta oferece suporte à adição de novas portas.
AddPort	Adiciona uma porta.
RemovePort	Remove uma porta.

Comentários

Um fornecedor de porta pode se identificar por nome e ID, adicionar e remover portas e enumerar todas as portas fornecidas pelo fornecedor de portas.

Requisitos

Cabeçalho: msdbg.h

Espaço para nome: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Compartilhar via