Partager via


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.

Voir aussi