IDebugClient3::ConnectSession-Methode (dbgeng.h)

Artikel
02/06/2025

Die ConnectSession-Methode verknüpft den Client mit einer vorhandenen Debuggersitzung.

Syntax

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

Parameter

[in] Flags

Gibt eine Bit-Gruppe von Optionskennzeichnungen für die Verbindung mit der Sitzung an. Die möglichen Werte dieser Flags sind:

Flagge	Beschreibung
DEBUG_CONNECT_SESSION_NO_VERSION	Geben Sie das Debuggermodul nichtVersion an diesen Client aus.
DEBUG_CONNECT_SESSION_NO_ANNOUNCE	Geben Sie keine Meldung aus, die andere Clients darüber benachrichtigt, dass dieser Client verbunden ist.

[in] HistoryLimit

Gibt die maximale Anzahl von Zeichen aus dem Verlauf der Sitzung an, die bei der Verbindung an die Ausgabe dieses Clients gesendet werden soll.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Wenn das Clientobjekt eine Verbindung mit einer Sitzung herstellt, wird die neueste Ausgabe der Sitzung an den Client gesendet. Wenn die Sitzung zurzeit auf die Eingabe wartet, erhält das Clientobjekt die Möglichkeit, Eingaben bereitzustellen. Daher synchronisiert das Clientobjekt mit der Eingabe und Ausgabe der Sitzung.

Der Client wird zu einem primären Client und wird in der Liste der Clients in der Ausgabe des .clients Debuggerbefehls angezeigt.

Weitere Informationen zum Debuggen von Clients finden Sie unter Debugging Server und Debugging Client. Weitere Informationen zu Debuggersitzungen finden Sie unter Debugging Session and Execution Model.