Compartilhar via


Método IDebugHost::GetHostDefinedInterface (dbgmodel.h)

O método GetHostDefinedInterface retornará a interface privada main do host, se existir para o host fornecido. Para Ferramentas de Depuração para Windows, a interface retornada aqui é um IDebugClient (convertido em IUnknown).

Sintaxe

HRESULT GetHostDefinedInterface(
  IUnknown **hostUnk
);

Parâmetros

hostUnk

A interface privada principal do host de depuração é retornada aqui. Para Ferramentas de Depuração para Windows, essa é uma interface IDebugClient.

Retornar valor

Esse método retorna HRESULT que indica êxito ou falha. Um host que não tem uma interface privada que deseja expor aos clientes do modelo de dados pode retornar E_NOTIMPL aqui.

Comentários

Exemplo de código

ComPtr<IDebugHost> spHost; /* get the debug host */

// Get the debug host private interface back from the host interfaces.  
// This is **HOST SPECIFIC**
ComPtr<IUnknown> spPrivate;
if (SUCCEEDED(spHost->GetHostDefinedInterface(&spPrivate)))
{
    // As an example, consider DbgEng:
    ComPtr<IDebugClient> spClient;
    if (SUCCEEDED(spPrivate.As(&spClient)))
    {
        // spClient now contains a DbgEng IDebugClient!
    }
}

Requisitos

Requisito Valor
Cabeçalho dbgmodel.h

Confira também

Interface IDebugHost