IDebugClient ::ConnectSession, méthode (dbgeng.h)

Article
02/06/2025

La méthode ConnectSession joint le client à une session de débogueur existante.

Syntaxe

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

Paramètres

[in] Flags

Spécifie un jeu de bits d’indicateurs d’option pour la connexion à la session. Les valeurs possibles de ces indicateurs sont les suivantes :

Drapeau	Description
DEBUG_CONNECT_SESSION_NO_VERSION	Ne sortiez pas le moteur de débogueur version de ce client.
DEBUG_CONNECT_SESSION_NO_ANNOUNCE	Ne génèrez pas de message informant les autres clients que ce client a connectés.

[in] HistoryLimit

Spécifie le nombre maximal de caractères de l’historique de la session à envoyer à la sortie de ce client lors de la connexion.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

Lorsque l’objet client se connecte à une session, la sortie la plus récente de la session est envoyée au client. Si la session attend actuellement l’entrée, l’objet client a la possibilité de fournir une entrée. Ainsi, l’objet client se synchronise avec l’entrée et la sortie de la session.

Le client devient un client principal et apparaît parmi la liste des clients dans la sortie de la commande .clients du débogueur.

Pour plus d’informations sur le débogage des clients, consultez Débogage du serveur et du client de débogage. Pour plus d’informations sur les sessions de débogueur, consultez débogage de session et de modèle d’exécution.