IDebugProcess2::Attach
Collega il gestore di debug della sessione (SDM) al processo.
Sintassi
int Attach(
IDebugEventCallback2 pCallback,
Guid[] rgguidSpecificEngines,
uint celtSpecificEngines,
int[] rghrEngineAttach
);
Parametri
pCallback
[in] Oggetto IDebugEventCallback2 utilizzato per la notifica degli eventi di debug.
rgguidSpecificEngines
[in] Matrice di GUID dei motori di debug da usare per eseguire il debug dei programmi in esecuzione nel processo. Questo parametro può essere un valore Null. Pe altri dettagli, vedere la sezione Osservazioni.
celtSpecificEngines
[in] Numero di motori di debug nella rgguidSpecificEngines matrice e dimensioni della rghrEngineAttach matrice.
rghrEngineAttach
[in, out] Matrice di codici HRESULT restituiti dai motori di debug. Le dimensioni di questa matrice vengono specificate nel celtSpecificEngines parametro . Ogni codice è in S_OK genere o S_ATTACH_DEFERRED. Quest'ultimo indica che il DE è attualmente collegato a nessun programma.
Valore restituito
Se ha esito positivo, restituisce S_OK; in caso contrario, restituisce un codice di errore. Nella tabella seguente sono illustrati altri valori possibili.
| Valore | Descrizione |
|---|---|
E_ATTACH_DEBUGGER_ALREADY_ATTACHED |
Il processo specificato è già collegato al debugger. |
E_ATTACH_DEBUGGEE_PROCESS_SECURITY_VIOLATION |
Si è verificata una violazione di sicurezza durante la procedura di collegamento. |
E_ATTACH_CANNOT_ATTACH_TO_DESKTOP |
Non è possibile collegare un processo desktop al debugger. |
Osservazioni:
L'associazione a un processo collega SDM a tutti i programmi in esecuzione in tale processo che possono essere sottoposto a debug dai motori di debug (DE) specificati nella rgguidSpecificEngines matrice. Impostare il rgguidSpecificEngines parametro su un valore Null o includere GUID_NULL nella matrice per collegarsi a tutti i programmi del processo.
Tutti gli eventi di debug che si verificano nel processo vengono inviati all'oggetto IDebugEventCallback2 specificato. Questo IDebugEventCallback2 oggetto viene fornito quando il SDM chiama questo metodo.