IDebugProgram2
Cette interface représente un programme en cours d’exécution dans un processus.
Syntaxe
IDebugProgram2 : IUnknown
Remarques pour les implémenteurs
Le moteur de débogage (DE) et un fournisseur de ports personnalisé implémentent cette interface pour représenter un programme dans un processus. Le gestionnaire de débogage de session (SDM) implémente également cette interface pour fournir des informations à Attacher.
Remarques pour les appelants
L’événement IDebugProgramCreateEvent2 retourne cette interface pour un nouveau programme. Cette interface est également utilisée comme paramètre pour de nombreuses méthodes sur plusieurs interfaces.
Méthodes dans l'ordre Vtable
Le tableau suivant présente les méthodes de IDebugProgram2.
| Méthode | Description |
|---|---|
| EnumThreads | Énumère les threads qui s’exécutent dans ce programme. |
| GetName | Obtient le nom du programme. |
| GetProcess | Obtient le processus dans lequel ce programme s’exécute. |
| Terminer. | Termine ce programme. |
| Attacher | Joint à ce programme. |
| CanDetach | Détermine si un moteur de débogage (DE) peut se détacher du programme. |
| Détacher | Détache le débogueur de ce programme. |
| GetProgramId | Obtient un identificateur global unique pour ce programme. |
| GetDebugProperty | Obtient les propriétés du programme. |
| Execute | Continue d’exécuter ce programme à partir d’un état arrêté. Tout état d’exécution précédent est effacé. |
| Continuer | Continue d’exécuter ce programme à partir d’un état arrêté. Tout état d’exécution précédent est conservé. |
| Étape | Effectue une étape. |
| CauseBreak | Demande que ce programme arrête l’exécution la prochaine fois qu’un de ses threads exécute du code. |
| GetEngineInfo | Obtient le nom et l’identificateur du moteur de débogage (DE) exécutant ce programme. |
| EnumCodeContexts | Énumère les contextes de code d’une position donnée dans un fichier source. |
| GetMemoryBytes | Obtient les octets de mémoire pour ce programme. |
| GetDisassemblyStream | Obtient le flux de désassemblement pour ce programme ou une partie de ce programme. |
| EnumModules | Énumère les modules que ce programme a chargés et s’exécute. |
| GetENCUpdate | Obtient la mise à jour Edit and Continue (ENC) pour ce programme. Un moteur de débogage personnalisé n’implémente pas cette méthode (elle doit toujours retourner E_NOTIMPL). |
| EnumCodePaths | Énumère les chemins de code de ce programme. |
| WriteDump | Écrit un vidage dans un fichier. |
Spécifications
En-tête : msdbg.h
Espace de noms : Microsoft.VisualStudio.Debugger.Interop
Assembly : Microsoft.VisualStudio.Debugger.Interop.dll
Notes
Un programme est un conteneur de threads s’exécutant dans une architecture d’exécution particulière, tandis qu’un processus est constitué d’un ou plusieurs programmes.