Compartilhar via


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

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

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:

Bandeira Descrição
DEBUG_CONNECT_SESSION_NO_VERSION Não gere a versão do do mecanismo de depuradorpara esse cliente.
DEBUG_CONNECT_SESSION_NO_ANNOUNCE Não gere uma mensagem notificando outros clientes que esse cliente 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.

Valor de retorno

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

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

Observações

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 no momento, o objeto cliente terá a oportunidade de fornecer entrada. Assim, 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 .clients depurador.

Para obter mais informações sobre depuração de clientes, consulte Depurando o servidor e depurando o cliente. Para obter mais informações sobre sessões de depurador, consulte depuração de sessão e modelo de execução.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

DebugConnect

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

OutputServers

do StartServer