RaiseFailFastException-Funktion (errhandlingapi.h)

Artikel
08/23/2023

Löst eine Ausnahme aus, die alle Ausnahmehandler (frame- oder vektorbasiert) umgeht. Durch Auslösen dieser Ausnahme wird die Anwendung beendet und Windows-Fehlerberichterstattung aufgerufen, wenn Windows-Fehlerberichterstattung aktiviert ist.

Syntax

void RaiseFailFastException(
  [in, optional] PEXCEPTION_RECORD pExceptionRecord,
  [in, optional] PCONTEXT          pContextRecord,
  [in]           DWORD             dwFlags
);

Parameter

[in, optional] pExceptionRecord

Ein Zeiger auf eine EXCEPTION_RECORD-Struktur , die die Ausnahmeinformationen enthält. Sie müssen die Member ExceptionAddress und ExceptionCode angeben.

Wenn dieser Parameter NULL ist, erstellt die Funktion einen Ausnahmedatensatz und legt den ExceptionCode-Member auf STATUS_FAIL_FAST_EXCEPTION fest. Die Funktion legt auch den ExceptionAddress-Member fest, wenn der dwFlags-Parameter das flag FAIL_FAST_GENERATE_EXCEPTION_ADDRESS enthält.

[in, optional] pContextRecord

Ein Zeiger auf eine CONTEXT-Struktur , die die Kontextinformationen enthält. Wenn NULL, generiert diese Funktion den Kontext (der Kontext stimmt jedoch nicht genau mit dem Kontext des Aufrufers überein).

[in] dwFlags

Sie können null oder das folgende Flag angeben, das das Verhalten dieser Funktion steuert:

Wert	Bedeutung
FAIL_FAST_GENERATE_EXCEPTION_ADDRESS 0x1	Bewirkt , dass RaiseFailFastException die ExceptionAddress von EXCEPTION_RECORD auf die Rückgabeadresse dieser Funktion legt (die nächste Anweisung im Aufrufer nach dem Aufruf von RaiseFailFastException). Diese Funktion legt die Ausnahmeadresse nur fest, wenn ExceptionAddress nicht NULL ist.

Rückgabewert

Keine

Bemerkungen

In der Regel rufen Sie diese Funktion auf, wenn sich Ihre Anwendung in einem fehlerhaften Zustand befindet und Sie die Anwendung sofort beenden und einen Windows-Fehlerbericht erstellen möchten.

Wenn der WER-Dienst deaktiviert ist oder nicht gestartet werden kann oder kein Debugger an den Prozess angefügt ist, wird der Prozess beendet.

Diese Funktion löst eine Ausnahme für die zweite Chance aus. Wenn DAS JIT-Debuggen aktiviert ist, wird ein Debugger an den Prozess angefügt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	errhandlingapi.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Environment.FailFast

Freigeben über