Attachement au programme

Article
05/17/2015

Après avoir enregistré vos programmes avec le port approprié, vous devez attacher le débogueur au programme que vous voulez déboguer.

Choisir de l'attachement

Il existe trois façons dont le gestionnaire de débogage de session (SDM) tente de s'attacher au programme en cours de débogage.

Pour les programmes qui sont lancées par le moteur de débogage via la méthode d' IDebugEngineLaunch2 : : LaunchSuspended (standard des langages interprètes, par exemple), le SDM obtient l'interface d' IDebugProgramNodeAttach2 de l'objet d' IDebugProgramNode2 associé au programme en cours attaché. Si le SDM peut obtenir l'interface d' IDebugProgramNodeAttach2 , le SDM appelle ensuite la méthode d' IDebugProgramNodeAttach2 : : OnAttach . La méthode d' IDebugProgramNodeAttach2::OnAttach retourne S_OK pour indiquer qu'elle ne dispose pas attachée le programme et que d'autres tentatives peuvent être effectuées attachement au programme.
Si le SDM peut obtenir l'interface d' IDebugProgramEx2 du programme en cours attaché, le SDM appelle la méthode d' IDebugProgramEx2 : : Attachement . Cette approche est généralement utilisé pour les programmes lancées à distance par le fournisseur de port.
Si le programme ne peut pas être attaché via les méthodes d' IDebugProgramNodeAttach2::OnAttach ou d' IDebugProgramEx2::Attach , les charges de SDM le moteur de débogage (si ce n'est déjà chargé) en appelant la fonction de CoCreateInstance et appelle ensuite la méthode d' IDebugEngine2 : : Attachement . Cette approche est typique pour les programmes s'exécutent localement par un fournisseur de port.

Il est également possible qu'un fournisseur de port appelle la méthode d' IDebugEngine2::Attach dans l'implémentation personnalisée du fournisseur de port de la méthode d' IDebugProgramEx2::Attach . En général dans ce cas, le fournisseur de port lance le moteur de débogage sur l'ordinateur distant.

La pièce jointe est réalisée lorsque le gestionnaire de débogage de (SDM) session appelle la méthode d' IDebugEngine2 : : Attachement .

Si vous exécutez votre De dans le même processus que l'application à déboguer, vous devez implémenter les méthodes suivantes pour IDebugProgramNode2:

Une fois que la méthode d' IDebugEngine2::Attach appelée, suivez ces étapes dans votre implémentation de la méthode d' IDebugEngine2::Attach :

envoyez un objet événement d' IDebugEngineCreateEvent2 au SDM. Pour plus d'informations, consultez événements d'émission.
Appelez la méthode d' IDebugProgram2 : : GetProgramId sur l'objet d' IDebugProgram2 passé à la méthode d' IDebugEngine2::Attach .

Retourne GUID utilisé pour identifier le programme. GUID doit être stocké dans l'objet qui représente le programme local au De, et il doit être retourné lorsque la méthode d' IDebugProgram2::GetProgramId est appelée sur l'interface d' IDebugProgram2 .

Notes

si vous implémentez l'interface d' IDebugProgramNodeAttach2 , GUID du programme est passé à la méthode d' IDebugProgramNodeAttach2::OnAttach .cet GUID est utilisé pour GUID du programme retourné par la méthode d' IDebugProgram2::GetProgramId .
envoyez un objet événement d' IDebugProgramCreateEvent2 pour informer le SDM que l'objet local d' IDebugProgram2 a été créé pour représenter le programme au De. Pour plus d'informations, consultez événements d'émission.

Notes

Ce n'est pas le même objet d' IDebugProgram2 qui a été passé à la méthode d' IDebugEngine2::Attach .L'objet précédemment passé d' IDebugProgram2 est identifié par le port uniquement et est un objet distinct.