Función DebugConnect (dbgeng.h)

Las funciones DebugConnect y DebugConnectWide crean un nuevo objeto de cliente y devuelven un puntero de interfaz a él. El objeto de cliente se conectará a un host remoto.

Sintaxis

C++

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

Parámetros

[in] RemoteOptions

Especifica cómo se conectará el motor del depurador al host remoto. Estas son las mismas opciones que se pasan a la opción -remote en la línea de comandos. Para obtener más información sobre la sintaxis de esta cadena, consulte Activar un cliente de depuración.

[in] InterfaceId

Especifica el identificador de interfaz (IID) de la interfaz de cliente del motor de depurador deseado. Este es el tipo de la interfaz que se devolverá en Interfaz. Para obtener información sobre el identificador de interfaz, vea Using Client Objects.

[out] Interface

Recibe un puntero de interfaz para el nuevo cliente. El tipo de esta interfaz se especifica mediante InterfaceId.

Valor devuelto

Este método también puede devolver valores de error. Consulte valores devueltos para obtener más información.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.

Observaciones

Al igual que con IUnknown::QueryInterface, cuando ya no se necesita la interfaz devuelta, se debe llamar a su método IUnknown::Release.

No es necesario llamar a CoInitialize, CoInitializeExo OleInitialize para usar esta función e interfaces obtenidas por él.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)

Consulte también

objetos de cliente

Servidor de procesos y cliente inteligente