IDebugProgram2IDebugProgram2

Cette interface représente un programme qui s’exécute dans un processus.This interface represents a program that is running in a process.

SyntaxeSyntax

IDebugProgram2 : IUnknown  

Notes pour les implémenteursNotes for Implementers

Le moteur de débogage (DE) et un fournisseur de port personnalisé implémentent cette interface pour représenter un programme dans un processus.The debug engine (DE) and a custom port supplier implement this interface to represent a program in a process. Le Gestionnaire de session de débogage (SDM) implémente également cette interface pour fournir des informations à attacher.The session debug manager (SDM) also implements this interface to provide information to Attach.

Remarques pour les appelantsNotes for Callers

Le IDebugProgramCreateEvent2 événement retourne cette interface pour un nouveau programme.The IDebugProgramCreateEvent2 event returns this interface for a new program. Cette interface est également utilisée en tant que paramètre pour de nombreuses méthodes sur plusieurs interfaces.This interface is also used as a parameter for many methods on multiple interfaces.

Méthodes dans l'ordre VtableMethods in Vtable Order

Le tableau suivant présente les méthodes de IDebugProgram2.The following table shows the methods of IDebugProgram2.

MéthodeMethod DescriptionDescription
EnumThreadsEnumThreads Énumère les threads qui sont exécutent dans ce programme.Enumerates the threads that are running in this program.
GetNameGetName Obtient le nom du programme.Gets the name of the program.
GetProcessGetProcess Obtient le processus de ce programme est en cours d’exécution dans.Gets the process that this program is running in.
ArrêterTerminate Met fin à ce programme.Terminates this program.
AttacherAttach Joint à ce programme.Attaches to this program.
CanDetachCanDetach Détermine si un moteur de débogage (DE) pouvez détacher à partir du programme.Determines if a debug engine (DE) can detach from the program.
DétacherDetach Détache le débogueur à partir de ce programme.Detaches the debugger from this program.
GetProgramIdGetProgramId Obtient un identificateur global unique pour ce programme.Gets a globally unique identifier for this program.
GetDebugPropertyGetDebugProperty Obtient les propriétés de programme.Gets program properties.
ExécuterExecute Continue de s’exécuter ce programme à partir d’un état arrêté.Continues running this program from a stopped state. Tout état de l’exécution précédente est désactivé.Any previous execution state is cleared.
ContinueContinue Continue de s’exécuter ce programme à partir d’un état arrêté.Continues running this program from a stopped state. N’importe quel état de l’exécution précédente est conservé.Any previous execution state is preserved.
StepStep Effectue une étape.Performs a step.
CauseBreakCauseBreak Demandes que ce programme s’arrêter l’exécution de la prochaine heure à laquelle un de ses exécute le code threads.Requests that this program stop execution the next time one of its threads runs code.
GetEngineInfoGetEngineInfo Obtient le nom et l’identificateur du moteur de débogage (DE) ce programme en cours d’exécution.Gets the name and identifier of the debug engine (DE) running this program.
EnumCodeContextsEnumCodeContexts Énumère les contextes de code pour une position donnée dans un fichier source.Enumerates the code contexts for a given position in a source file.
GetMemoryBytesGetMemoryBytes Obtient les octets de mémoire pour ce programme.Gets the memory bytes for this program.
GetDisassemblyStreamGetDisassemblyStream Obtient le flux de code machine de ce programme ou d’une partie de ce programme.Gets the disassembly stream for this program or part of this program.
EnumModulesEnumModules Énumère les modules qui a chargé de ce programme et s’exécute.Enumerates the modules that this program has loaded and is executing.
GetENCUpdateGetENCUpdate Obtient la mise à jour de modifier & Continuer (ENC) pour ce programme.Gets the Edit and Continue (ENC) update for this program.

Un moteur de débogage personnalisé n’implémente pas cette méthode (elle doit toujours retourner E_NOTIMPL).A custom debug engine does not implement this method (it should always return E_NOTIMPL).
EnumCodePathsEnumCodePaths Énumère les chemins de code de ce programme.Enumerates the code paths of this program.
WriteDumpWriteDump Écrit un fichier de vidage dans un fichier.Writes a dump to a file.

SpécificationsRequirements

En-tête : msdbg.hHeader: msdbg.h

Namespace : Microsoft.VisualStudio.Debugger.InteropNamespace: Microsoft.VisualStudio.Debugger.Interop

Assembly : Microsoft.VisualStudio.Debugger.Interop.dllAssembly: Microsoft.VisualStudio.Debugger.Interop.dll

NotesRemarks

Un programme est un conteneur de thread à exécuter dans une architecture d’exécution particulière, alors qu’un processus est constitué d’un ou plusieurs programmes.A program is a thread container running in a particular run-time architecture, while a process is made up of one or more programs.

Voir aussiSee Also

Interfaces de base Core Interfaces
GetProgram GetProgram
Suivant Next
Événement Event
Joindre Attach
DestroyProgram DestroyProgram
Événement Event
Attach_V7Attach_V7