UnhandledExceptionFilter-Funktion (errhandlingapi.h)

Artikel
08/23/2023

Eine anwendungsdefinierte Funktion, die nicht behandelte Ausnahmen an den Debugger übergibt, wenn der Prozess gedebuggt wird. Andernfalls wird optional ein Meldungsfeld für Anwendungsfehler angezeigt, und der Ausnahmehandler wird ausgeführt. Diese Funktion kann nur innerhalb des Filterausdrucks eines Ausnahmehandlers aufgerufen werden.

Syntax

LONG UnhandledExceptionFilter(
  [in] _EXCEPTION_POINTERS *ExceptionInfo
);

Parameter

[in] ExceptionInfo

Ein Zeiger auf eine EXCEPTION_POINTERS-Struktur , die eine Beschreibung der Ausnahme und des Prozessorkontexts zum Zeitpunkt der Ausnahme angibt. Dieser Zeiger ist der Rückgabewert eines Aufrufs der GetExceptionInformation-Funktion .

Rückgabewert

Die Funktion gibt einen der folgenden Werte zurück.

Rückgabecode/-wert	BESCHREIBUNG
EXCEPTION_CONTINUE_SEARCH 0x0	Der Prozess wird gedebuggt, sodass die Ausnahme (als zweite Chance) an den Debugger der Anwendung übergeben werden sollte.
EXCEPTION_EXECUTE_HANDLER 0x1	Wenn das SEM_NOGPFAULTERRORBOX-Flag in einem vorherigen Aufruf von SetErrorMode angegeben wurde, wird kein Meldungsfeld für Anwendungsfehler angezeigt. Die Funktion gibt die Steuerung an den Ausnahmehandler zurück, der alle geeigneten Aktionen ausführen kann.

Hinweise

Wenn der Prozess nicht debuggt wird, zeigt die Funktion je nach aktuellem Fehlermodus ein Meldungsfeld für Anwendungsfehler an. Das Standardverhalten besteht darin, das Dialogfeld anzuzeigen. Dies kann jedoch deaktiviert werden, indem SEM_NOGPFAULTERRORBOX in einem Aufruf der SetErrorMode-Funktion angegeben wird.

Das System verwendet UnhandledExceptionFilter intern, um Ausnahmen zu behandeln, die während der Prozess- und Threaderstellung auftreten.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	errhandlingapi.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll