IDebugProcess2::Attach
Attache le gestionnaire de débogage de session (SDM) au processus.
Syntaxe
int Attach(
IDebugEventCallback2 pCallback,
Guid[] rgguidSpecificEngines,
uint celtSpecificEngines,
int[] rghrEngineAttach
);
Paramètres
pCallback
[in] Objet IDebugEventCallback2 utilisé pour la notification d’événement de débogage.
rgguidSpecificEngines
[in] Tableau de GUID des moteurs de débogage à utiliser pour déboguer des programmes en cours d’exécution dans le processus. Ce paramètre peut être une valeur Null. Pour plus d’informations, consultez Remarques.
celtSpecificEngines
[in] Nombre de moteurs de débogage dans le rgguidSpecificEngines tableau et la taille du rghrEngineAttach tableau.
rghrEngineAttach
[in, out] Tableau de codes HRESULT retournés par les moteurs de débogage. La taille de ce tableau est spécifiée dans le celtSpecificEngines paramètre. Chaque code est généralement soit S_OK ou S_ATTACH_DEFERRED. Ce dernier indique que le DE est actuellement attaché à aucun programme.
Valeur de retour
En cas de réussite, retourne S_OK , sinon, retourne un code d'erreur. Le tableau suivant présente d’autres valeurs possibles.
| Valeur | Description |
|---|---|
E_ATTACH_DEBUGGER_ALREADY_ATTACHED |
Le processus spécifié est déjà attaché au débogueur. |
E_ATTACH_DEBUGGEE_PROCESS_SECURITY_VIOLATION |
Une violation de sécurité s’est produite pendant la procédure d’attachement. |
E_ATTACH_CANNOT_ATTACH_TO_DESKTOP |
Un processus de bureau ne peut pas être attaché au débogueur. |
Notes
L’attachement à un processus attache le SDM à tous les programmes exécutés dans ce processus qui peuvent être débogués par les moteurs de débogage (DE) spécifiés dans le rgguidSpecificEngines tableau. Définissez le rgguidSpecificEngines paramètre sur une valeur Null ou incluez GUID_NULL dans le tableau pour l’attacher à tous les programmes du processus.
Tous les événements de débogage qui se produisent dans le processus sont envoyés à l’objet IDebugEventCallback2 donné. Cet IDebugEventCallback2 objet est fourni lorsque le SDM appelle cette méthode.