Função DebugConnect (dbgeng.h)

Artigo
02/06/2025

As funções DebugConnect e DebugConnectWide criam um novo objeto cliente e retornam um ponteiro de interface para ele. O objeto cliente será conectado a um host remoto.

Sintaxe

HRESULT DebugConnect(
  [in]  PCSTR  RemoteOptions,
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

Parâmetros

[in] RemoteOptions

Especifica como o mecanismo de depurador se conectará ao host remoto. Essas são as mesmas opções que são passadas para a opção -remote na linha de comando. Para obter detalhes sobre a sintaxe dessa cadeia de caracteres, consulte Ativando um cliente de depuração.

[in] InterfaceId

Especifica o IID (identificador de interface) da interface do cliente do mecanismo de depurador desejado. Esse é o tipo da interface que será retornada em Interface. Para obter informações sobre o identificador de interface, consulte Usando objetos cliente.

[out] Interface

Recebe um ponteiro de interface para o novo cliente. O tipo dessa interface é especificado por InterfaceId.

Valor de retorno

Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Observações

Assim como acontece com IUnknown::QueryInterface, quando a interface retornada não é mais necessária, seu método IUnknown::Release deve ser chamado.

Você não precisa chamar CoInitialize, CoInitializeExou OleInitialize para usar essa função e interfaces obtidas por ela.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

objetos cliente

Servidor de Processo e Cliente Inteligente

Partilhar via