IDebugProgram2
Diese Schnittstelle stellt ein Programm dar, das in einem Prozess ausgeführt wird.
Syntax
IDebugProgram2 : IUnknown
Hinweise für Implementierer
Das Debugmodul (DE) und ein benutzerdefinierter Portanbieter implementieren diese Schnittstelle, um ein Programm in einem Prozess darzustellen. Der Sitzungsdebug-Manager (SDM) implementiert auch diese Schnittstelle, um Informationen zum Anfügen bereitzustellen.
Hinweise für Aufrufer
Das IDebugProgramCreateEvent2-Ereignis gibt diese Schnittstelle für ein neues Programm zurück. Diese Schnittstelle wird auch als Parameter für viele Methoden für mehrere Schnittstellen verwendet.
Methoden in Vtable-Reihenfolge
In der folgenden Tabelle sind die Methoden von IDebugProgram2 aufgeführt.
| Methode | Beschreibung |
|---|---|
| EnumThreads | Listet die Threads auf, die in diesem Programm ausgeführt werden. |
| GetName | Ruft den Namen des Programms ab. |
| GetProcess | Ruft den Prozess ab, in dem dieses Programm ausgeführt wird. |
| Terminate | Beendet dieses Programm. |
| Anfügen | Fügt dieses Programm an. |
| CanDetach | Bestimmt, ob ein Debugmodul (DE) vom Programm getrennt werden kann. |
| Trennen | Trennt den Debugger von diesem Programm. |
| GetProgramId | Ruft einen global eindeutigen Bezeichner für dieses Programm ab. |
| GetDebugProperty | Ruft Programmeigenschaften ab. |
| Ausführen | Setzt die Ausführung dieses Programms aus einem angehaltenen Zustand fort. Jeder vorherige Ausführungszustand wird gelöscht. |
| Continue | Setzt die Ausführung dieses Programms aus einem angehaltenen Zustand fort. Alle vorherigen Ausführungszustände bleiben erhalten. |
| Schritt | Führt einen Schritt aus. |
| CauseBreak | Fordert an, dass dieses Programm die Ausführung beim nächsten Ausführen eines seiner Threads beendet. |
| GetEngineInfo | Ruft den Namen und den Bezeichner des Debugmoduls (DE) ab, das dieses Programm ausführt. |
| EnumCodeContexts | Listet die Codekontexte für eine bestimmte Position in einer Quelldatei auf. |
| GetMemoryBytes | Ruft die Speicherbytes für dieses Programm ab. |
| GetDisassemblyStream | Ruft den Demontagedatenstrom für dieses Programm oder einen Teil dieses Programms ab. |
| EnumModules | Listet die Module auf, die dieses Programm geladen hat und ausgeführt wird. |
| GetENCUpdate | Ruft das Update edit and Continue (ENC) für dieses Programm ab. Ein benutzerdefiniertes Debugmodul implementiert diese Methode nicht (es sollte immer zurückgegeben werden E_NOTIMPL). |
| EnumCodePaths | Listet die Codepfade dieses Programms auf. |
| WriteDump | Schreibt ein Abbild in eine Datei. |
Anforderungen
Header: msdbg.h
Namespace: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll
Hinweise
Ein Programm ist ein Threadcontainer, der in einer bestimmten Laufzeitarchitektur ausgeführt wird, während ein Prozess aus einem oder mehreren Programmen besteht.