IDebugEventCallbacks::Exception-Methode (dbgeng.h)

Artikel
02/06/2025

Die Exception callback-Methode wird vom Modul aufgerufen, wenn ein Ausnahmedebuggingereignis im Ziel auftritt.

Syntax

HRESULT Exception(
  [in] PEXCEPTION_RECORD64 Exception,
  [in] ULONG               FirstChance
);

Parameter

[in] Exception

Gibt die Art der Ausnahme an. EXCEPTION_RECORD64 wird in winnt.h definiert.

[in] FirstChance

Gibt an, ob diese Ausnahme zuvor aufgetreten ist. Ein Wert ungleich Null bedeutet, dass dies das erste Mal ist, wenn die Ausnahme aufgetreten ist ("erste Chance"). Ein Nullwert bedeutet, dass die Ausnahme bereits allen möglichen Handlern angeboten wurde und jeder abgelehnt wurde, um sie zu behandeln ("zweite Chance").

Rückgabewert

Diese Methode gibt einen DEBUG_STATUS_XXX Wert zurück, der angibt, wie die Ausführung des Ziels fortgesetzt werden soll, nachdem das Modul dieses Ereignis verarbeitet hat. Ausführliche Informationen zur Behandlung dieses Werts finden Sie unter Monitoring Events.

Bemerkungen

Diese Methode wird nur vom Modul aufgerufen, wenn das DEBUG_EVENT_EXCEPTION Flag in der Maske festgelegt wird, die von IDebugEventCallbacks::GetInterestMaskzurückgegeben wird.

Da die Struktur, auf die Exception verweist, nach dem Zurückgeben dieser Methode möglicherweise gelöscht werden kann, sollten Implementierungen von IDebugEventCallbacks nach der Rückgabe nicht auf diese Struktur zugreifen.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Monitoring Events.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Freigeben über