IDebugClient::ConnectSession method

The ConnectSession method joins the client to an existing debugger session.

Syntax


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

Parameters

Flags [in]

Specifies a bit-set of option flags for connecting to the session. The possible values of these flags are:

FlagDescription

DEBUG_CONNECT_SESSION_NO_VERSION

Do not output the debugger engine's version to this client.

DEBUG_CONNECT_SESSION_NO_ANNOUNCE

Do not output a message notifying other clients that this client has connected.

 

HistoryLimit [in]

Specifies the maximum number of characters from the session's history to send to this client's output upon connection.

Return value

This method may also return error values. See Return Values for more details.

Return codeDescription
S_OK

The method was successful.

 

Remarks

When the client object connects to a session, the most recent output from the session is sent to the client. If the session is currently waiting on input, the client object is given the opportunity to provide input. Thus, the client object synchronizes with the session's input and output.

The client becomes a primary client and will appear among the list of clients in the output of the .clients debugger command.

For more information about debugging clients, see Debugging Server and Debugging Client. For more information about debugger sessions, see Debugging Session and Execution Model.

Requirements

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugClient
IDebugClient2
IDebugClient3
IDebugClient4
IDebugClient5
DebugConnect
StartServer
OutputServers

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.