IDebugEngine2
Diese Schnittstelle stellt ein Debugmodul (DE) dar. Es wird verwendet, um verschiedene Aspekte einer Debugsitzung zu verwalten, von der Erstellung von Haltepunkten bis zum Festlegen und Löschen von Ausnahmen.
Syntax
IDebugEngine2 : IUnknown
Hinweise für Implementierer
Diese Schnittstelle wird von einer benutzerdefinierten DE implementiert, um das Debuggen von Programmen zu verwalten. Diese Schnittstelle muss von der DE implementiert werden.
Hinweise für Aufrufer
Diese Schnittstelle wird vom Sitzungsdebug-Manager (SDM) aufgerufen, um die Debugsitzung zu verwalten, einschließlich der Verwaltung von Ausnahmen, erstellen von Haltepunkten und Reagieren auf synchrone Ereignisse, die von der DE gesendet werden.
Methoden in Vtable-Reihenfolge
In der folgenden Tabelle sind die Methoden von IDebugEngine2 aufgeführt.
| Methode | Beschreibung |
|---|---|
| EnumPrograms | Erstellt einen Enumerator für alle Programme, die von einer DE gedebuggt werden. |
| Anfügen | Fügt eine DE an ein Programm an. |
| CreatePendingBreakpoint | Erstellt einen ausstehenden Haltepunkt in der DE. |
| SetException | Gibt an, wie die DE eine bestimmte Ausnahme behandeln soll. |
| RemoveSetException | Entfernt die angegebene Ausnahme, sodass sie nicht mehr vom Debugmodul behandelt wird. |
| RemoveAllSetExceptions | Entfernt die Liste der Ausnahmen, die die IDE für eine bestimmte Laufzeitarchitektur oder Sprache festgelegt hat. |
| GetEngineID | Ruft die GUID der DE ab. |
| DestroyProgram | Informiert eine DE, dass das angegebene Programm atypisch beendet wurde und dass die DE alle Verweise auf das Programm sauber und ein Programm zerstören Ereignis senden sollte. |
| ContinueFromSynchronousEvent | Wird vom SDM aufgerufen, um anzugeben, dass ein synchrones Debugereignis, das zuvor von der DE an das SDM gesendet wurde, empfangen und verarbeitet wurde. |
| SetLocale | Legt das Gebietsschema der DE fest. |
| SetRegistryRoot | Legt den Registrierungsstamm fest, der derzeit von der DE verwendet wird. |
| SetMetric | Legt eine Metrik fest. |
| CauseBreak | Fordert an, dass alle Programme, die von dieser DE gedebuggt werden, die Ausführung beenden, wenn eines ihrer Threads das nächste Mal versucht, ausgeführt zu werden. |
Anforderungen
Header: Msdbg.h
Namespace: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll