Metodo IDebugClient3::ConnectSession (dbgeng.h)

Articolo
03/08/2023

Il metodo ConnectSession aggiunge il client a una sessione del debugger esistente.

Sintassi

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

Parametri

[in] Flags

Specifica un set di flag di opzioni per la connessione alla sessione. I valori possibili di questi flag sono:

Flag	Descrizione
DEBUG_CONNECT_SESSION_NO_VERSION	Non restituire la versione del motore del debugger a questo client.
DEBUG_CONNECT_SESSION_NO_ANNOUNCE	Non inviare un messaggio che notifica ad altri client che il client è connesso.

[in] HistoryLimit

Specifica il numero massimo di caratteri della cronologia della sessione da inviare all'output del client al momento della connessione.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Quando l'oggetto client si connette a una sessione, l'output più recente della sessione viene inviato al client. Se la sessione è attualmente in attesa di input, l'oggetto client ha la possibilità di fornire l'input. L'oggetto client viene quindi sincronizzato con l'input e l'output della sessione.

Il client diventa un client primario e verrà visualizzato tra l'elenco dei client nell'output del comando debugger .client .

Per altre informazioni sul debug dei client, vedere Debug del server e del client di debug. Per altre informazioni sulle sessioni del debugger, vedere Debug di sessioni ed esecuzione del modello di esecuzione.