Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.