Partager via


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.

Voir aussi