Metodo IDebugClient::ConnectSession (dbgeng.h)

Articolo
02/06/2025

Il metodo ConnectSession unisce 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 opzione di bit per la connessione alla sessione. I valori possibili di questi flag sono:

Bandiera	Descrizione
DEBUG_CONNECT_SESSION_NO_VERSION	Non restituire il motore del debugger versione di questo client.
DEBUG_CONNECT_SESSION_NO_ANNOUNCE	Non inviare un messaggio per notificare 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 altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

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 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 .clients debugger.

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 della sessione e del modello di esecuzione.