Função DebugConnect (dbgeng.h)

  • Artigo

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 do 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 desejada. Esse é o tipo da interface que será retornada em Interface. Para obter informações sobre o identificador de interface, consulte Using Client Objects.

[out] Interface

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

Retornar valor

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

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

Comentários

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, CoInitializeEx ou OleInitialize para usar essa função e interfaces obtidas por ela.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

Objetos de cliente

Servidor de processo e cliente inteligente