Freigeben über


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

Siehe auch