IDebugExceptionEvent2
Das Debugmodul (DE) sendet diese Schnittstelle an den Sitzungsdebug-Manager (SDM), wenn eine Ausnahme im derzeit ausgeführten Programm ausgelöst wird.
Syntax
IDebugExceptionEvent2 : IUnknown
Hinweise für Implementierer
Die DE implementiert diese Schnittstelle, um zu melden, dass beim Debuggen des Programms eine Ausnahme aufgetreten ist. Die IDebugEvent2-Schnittstelle muss auf demselben Objekt wie diese Schnittstelle implementiert werden. Das SDM verwendet QueryInterface , um auf die IDebugEvent2 Schnittstelle zuzugreifen.
Hinweise für Aufrufer
Die DE erstellt und sendet dieses Ereignisobjekt, um eine Ausnahme zu melden. Das Ereignis wird mithilfe der Rückruffunktion IDebugEventCallback2 gesendet, die vom SDM bereitgestellt wird, wenn es an das zu debuggende Programm angefügt ist.
Methoden in Vtable-Reihenfolge
In der folgenden Tabelle sind die Methoden von IDebugExceptionEvent2 aufgeführt.
| Methode | Beschreibung |
|---|---|
| GetException | Ruft detaillierte Informationen zu der Ausnahme ab, die dieses Ereignis ausgelöst hat. |
| GetExceptionDescription | Ruft eine lesbare Beschreibung für die Ausnahme ab, die dieses Ereignis ausgelöst hat. |
| CanPassToDebuggee | Bestimmt, ob das Debugmodul (DE) die Option unterstützt, diese Ausnahme an das Programm zu übergeben, das beim Fortsetzen der Ausführung gedebuggt wird. |
| PassToDebuggee | Gibt an, ob die Ausnahme an das Programm übergeben werden soll, das beim Fortsetzen der Ausführung gedebuggt wird, oder ob die Ausnahme nicht Karte werden soll. |
Anforderungen
Header: msdbg.h
Namespace: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll
Hinweise
Vor dem Senden des Ereignisses überprüft die DE, ob dieses Ausnahmeereignis durch einen vorherigen Aufruf von SetException als First-Chance- oder Second-Chance-Ausnahme festgelegt wurde. Wenn es als Ausnahme der ersten Chance festgelegt wurde, wird das IDebugExceptionEvent2 Ereignis an das SDM gesendet. Wenn dies nicht der Fall ist, bietet die DE der Anwendung die Möglichkeit, die Ausnahme zu behandeln. Wenn kein Ausnahmehandler bereitgestellt wird und die Ausnahme als second-Chance-Ausnahme festgelegt wurde, wird das IDebugExceptionEvent2 Ereignis an das SDM gesendet. Andernfalls setzt die DE die Ausführung des Programms fort, und das Betriebssystem oder die Laufzeit behandelt die Ausnahme.