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

Artigo
02/23/2024

O método ConnectSession une o cliente a uma sessão existente do depurador.

Sintaxe

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

Parâmetros

[in] Flags

Especifica um conjunto de bits de sinalizadores de opção para se conectar à sessão. Os valores possíveis desses sinalizadores são:

Sinalizador	Descrição
DEBUG_CONNECT_SESSION_NO_VERSION	Não gere a versão do mecanismo de depurador para esse cliente.
DEBUG_CONNECT_SESSION_NO_ANNOUNCE	Não gere uma mensagem notificando outros clientes de que esse cliente se conectou.

[in] HistoryLimit

Especifica o número máximo de caracteres do histórico da sessão a serem enviados para a saída desse cliente após a conexão.

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

Quando o objeto cliente se conecta a uma sessão, a saída mais recente da sessão é enviada ao cliente. Se a sessão estiver aguardando a entrada, o objeto cliente terá a oportunidade de fornecer entrada. Portanto, o objeto cliente é sincronizado com a entrada e a saída da sessão.

O cliente se torna um cliente primário e aparecerá entre a lista de clientes na saída do comando do depurador .clients .

Para obter mais informações sobre como depurar clientes, consulte Depurando Servidor e Cliente de Depuração. Para obter mais informações sobre sessões do depurador, consulte Depurando o modelo de sessão e execução.