Método IDebugClient4::ConnectSession (dbgeng.h)

Artículo
08/07/2023

El método ConnectSession une el cliente a una sesión del depurador existente.

Sintaxis

HRESULT ConnectSession(
  [in] ULONG Flags,
  [in] ULONG HistoryLimit
);

Parámetros

[in] Flags

Especifica un conjunto de bits de marcas de opción para conectarse a la sesión. Los valores posibles de estas marcas son:

Marca	Descripción
DEBUG_CONNECT_SESSION_NO_VERSION	No se envía la versión del motor del depurador a este cliente.
DEBUG_CONNECT_SESSION_NO_ANNOUNCE	No envíe un mensaje que notifique a otros clientes que este cliente se ha conectado.

[in] HistoryLimit

Especifica el número máximo de caracteres del historial de la sesión que se va a enviar a la salida de este cliente tras la conexión.

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

Cuando el objeto de cliente se conecta a una sesión, la salida más reciente de la sesión se envía al cliente. Si la sesión está esperando actualmente la entrada, el objeto de cliente tiene la oportunidad de proporcionar la entrada. Por lo tanto, el objeto de cliente se sincroniza con la entrada y salida de la sesión.

El cliente se convierte en un cliente principal y aparecerá entre la lista de clientes en la salida del comando del depurador .clients .

Para obtener más información sobre la depuración de clientes, vea Debugging Server and Debugging Client. Para obtener más información sobre las sesiones del depurador, vea Depurar sesión y modelo de ejecución.