Función DebugConnect (dbgeng.h)

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

Sintaxis

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 Activación de 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 Interface. Para obtener información sobre el identificador de interfaz, vea Using Client Objects.

[out] Interface

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

Valor devuelto

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

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

Al igual que con IUnknown::QueryInterface, cuando la interfaz devuelta ya no es necesaria, se debe llamar al método IUnknown::Release .

No es necesario llamar a CoInitialize, CoInitializeEx ni OleInitialize para usar esta función e interfaces obtenidas por ella.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	dbgeng.h (include Dbgeng.h)

Consulte también

Objetos de cliente

Servidor de procesos y cliente inteligente