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

Artigo
02/06/2025

O método GetHostDefinedInterface retornará a interface privada principal do host, se isso existir para o host especificado. 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, esta é uma interface IDebugClient.

Valor de retorno

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

Observações

de 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

Consulte também

interface IDebugHost

Partilhar via