IDebugPortSupplier2

Artigo
05/17/2015

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

IDebugPortSupplier2 : IUnknown

Observações para Implementadores

Um fornecedor de porta personalizada implementa essa interface para representar um fornecedor de porta.

Observações para chamadores

Uma chamada para CoCreateInstance com um fornecedor de porta GUID retorna essa interface (isso é uma forma comum de obter esta 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 IDebugCoreServer2::GetPortSupplier retorna essa interface, que representa o fornecedor de porta atual que está sendo usado por Visual Studio.

IDebugPort2::GetPortSupplierRetorna a essa interface, que representa o fornecedor de porta que criou a porta.

IEnumDebugPortSuppliers2representa uma lista de IDebugPortSupplier interfaces (o IEnumDebugPortSuppliers interface é obtido do IDebugCoreServer2::EnumPortSuppliers, que representa todos os fornecedores porta registrados com Visual Studio).

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

Métodos na ordem de Vtable

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

Método	Descrição
IDebugPortSupplier2::GetPortSupplierName	Obtém o nome do fornecedor de porta.
IDebugPortSupplier2::GetPortSupplierId	Obtém o identificador de fornecedor de porta.
IDebugPortSupplier2::GetPort	Obtém uma porta de um fornecedor de porta.
IDebugPortSupplier2::EnumPorts	Enumera as portas que já existem.
IDebugPortSupplier2::CanAddPort	Verifica se um fornecedor de porta suporta a adição de novas portas.
IDebugPortSupplier2::AddPort	Adiciona uma porta.
IDebugPortSupplier2::RemovePort	Remove uma porta.

Comentários

Um fornecedor de porta pode se identificar por nome e identificação, adicionar e remover portas e enumerar todas as portas que o fornecedor de porta fornece.