Condividi tramite


IDebugProgramEx2::Attach

Collegare una sessione a un programma.

Sintassi

int Attach( 
   IDebugEventCallback2 pCallback,
   uint                 dwReason,
   IDebugSession2       pSession
);

Parametri

pCallback
[in] Oggetto IDebugEventCallback2 che rappresenta la funzione di callback a cui il motore di debug collegato invia eventi.

dwReason
[in] Valore dell'enumerazione ATTACH_REASON che descrive il motivo dell'operazione di collegamento.

pSession
[in] Valore che identifica in modo univoco la sessione collegata al programma.

Valore restituito

Se ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore. Questo metodo deve restituire E_ATTACH_DEBUGGER_ALREADY_ATTACHED se il programma è già collegato.

Osservazioni:

La porta che contiene il programma può usare il valore in pSession per determinare quale sessione sta tentando di collegarsi al programma. Ad esempio, se una porta consente la connessione di una sola sessione di debug a un processo alla volta, la porta può determinare se la stessa sessione è già collegata ad altri programmi nel processo.

Nota

L'interfaccia passata pSession deve essere considerata solo come un cookie, un valore che identifica in modo univoco il gestore di debug della sessione che si collega a questo programma. Nessuno dei metodi nell'interfaccia fornita è funzionale.

Vedi anche