IDebugExceptionEvent2

Artikel
05/16/2015

Das Debugmodul (DE) sendet diese Schnittstelle zum Debuggen von Manager der Sitzung (SDM), wenn das Programm in eine Ausnahme ausgelöst wird, das gerade ausgeführt wird.

IDebugExceptionEvent2 : IUnknown

Hinweise für Implementierer

DE implementiert diese Schnittstelle, um zu melden, dass eine Ausnahme aufgetreten ist im Programm, das gedebuggt wird. Die IDebugEvent2-Schnittstelle muss auf dasselbe Objekt wie diese Schnittstelle implementiert werden. Das SDM QueryInterface verwendet, um die IDebugEvent2-Schnittstelle zuzugreifen.

Hinweise für Aufrufer

DE erstellt und sendet das Ereignisobjekt, um eine Ausnahme zu melden. Das Ereignis wird mithilfe der IDebugEventCallback2 Rückruffunktion bereitgestellt, die vom SDM angegeben wurde, als sie angefügt haben dem Programm, das gedebuggt wurde.

Methoden in die Vtable-Reihenfolge

In der folgenden Tabelle werden die Methoden von IDebugExceptionEvent2an.

Methode	Beschreibung
IDebugExceptionEvent2::GetException	Ruft ausführliche Informationen über die Ausnahme ab, die das Ereignis ausgelöst hat.
IDebugExceptionEvent2::GetExceptionDescription	Ruft eine lesbare Beschreibung für die ausgelöste Ausnahme ab, die das Ereignis ausgelöst hat.
IDebugExceptionEvent2::CanPassToDebuggee	Bestimmt, ob das Debugmodul (DE) die Übergabe dieser Ausnahme in das Programm, das gedebuggt wird unterstützt, wenn die Ausführung fortgesetzt wird.
IDebugExceptionEvent2::PassToDebuggee	Gibt an, ob die Ausnahme an das Programm übergeben werden soll, das gedebuggt wird, wenn die Ausführung fortsetzt bzw. wenn die Ausnahme verworfen wird.

Anforderungen

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Hinweise

Bevor das Ereignis, die DE-Überprüfungen übertragen wird, um zu ermitteln, ob dies ein Ausnahmeereignis der ersten Chance und der zweiten Chance Ausnahme durch einen vorherigen Aufruf von IDebugEngine2::SetExceptionfestgelegt wurde. Wenn sie festgelegt wurde, dass eine Ausnahme der ersten Chance, wird das Ereignis an den IDebugExceptionEvent2 SDM gesendet. Wenn dies nicht der Fall ist, gibt DE der Anwendung eine Möglichkeit, die Ausnahme zu behandeln. Wenn kein Ausnahmehandler bereitgestellt wird und wenn die Ausnahme als Ausnahme der zweiten Chance festgelegt wurde, wird das Ereignis an den IDebugExceptionEvent2 SDM gesendet. Andernfalls führt DE Programmausführung fortgesetzt, und das Betriebssystem oder die Common Language Runtime behandelt die Ausnahme.