Méthode IDebugClient3 ::ConnectSession (dbgeng.h)

Article
02/26/2024

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 ensemble de bits d’indicateurs d’option pour la connexion à la session. Les valeurs possibles de ces indicateurs sont les suivantes :

Indicateur	Description
DEBUG_CONNECT_SESSION_NO_VERSION	Ne sortez pas la version du moteur du débogueur vers ce client.
DEBUG_CONNECT_SESSION_NO_ANNOUNCE	Ne sortez pas de message informant d’autres clients que ce client s’est connecté.

[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 retournée

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

Code de retour	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 une 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 dans la liste des clients dans la sortie de la commande .clients 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 modèle d’exécution.