IDebugClient3::ConnectSession-Methode (dbgeng.h)

Artikel
02/26/2024

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

Syntax

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

Parameter

[in] Flags

Gibt einen Bitsatz von Optionsflags für die Verbindung mit der Sitzung an. Die möglichen Werte dieser Flags sind:

Flag	Beschreibung
DEBUG_CONNECT_SESSION_NO_VERSION	Geben Sie die Version der Debugger-Engine nicht an diesen Client aus.
DEBUG_CONNECT_SESSION_NO_ANNOUNCE	Geben Sie keine Meldung aus, die andere Clients darüber informiert, dass dieser Client eine Verbindung hergestellt hat.

[in] HistoryLimit

Gibt die maximale Anzahl von Zeichen aus dem Sitzungsverlauf an, die bei der Verbindung an die Ausgabe dieses Clients gesendet werden sollen.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

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

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

Weitere Informationen zum Debuggen von Clients finden Sie unter Debuggen von Server und Debugclient. Weitere Informationen zu Debuggersitzungen finden Sie unter Debuggen von Sitzungs- und Ausführungsmodellen.