Metodo IDebugClient::ConnectSession (dbgeng.h)

Articolo
02/25/2024

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 bit di flag di opzione 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 restituire un messaggio che informa altri client che il client è connesso.

[in] HistoryLimit

Specifica il numero massimo di caratteri dalla 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 è 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 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 .clients .

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.