IDebugEventCallbacks::Exception-Methode (dbgeng.h)

  • Artikel

Die Exception-Rückrufmethode wird von der Engine aufgerufen, wenn im Ziel ein Ausnahmedebuggenereignis auftritt.

Syntax

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

Parameter

[in] Exception

Gibt die Art der Ausnahme an. EXCEPTION_RECORD64 ist 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, dass die Ausnahme auftritt ("erste Chance"). Ein Nullwert bedeutet, dass die Ausnahme bereits allen möglichen Handlern angeboten wurde und jeder die Behandlung abgelehnt hat ("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 die Engine dieses Ereignis verarbeitet hat. Ausführliche Informationen dazu, wie die Engine diesen Wert behandelt, finden Sie unter Überwachen von Ereignissen.

Hinweise

Diese Methode wird nur von der Engine aufgerufen, wenn das flag DEBUG_EVENT_EXCEPTION in der von IDebugEventCallbacks::GetInterestMask zurückgegebenen Maske festgelegt ist.

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

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter Überwachen von Ereignissen.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (dbgeng.h einschließen)