Freigeben über


UnhandledExceptionFilter-Funktion (errhandlingapi.h)

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

Siehe auch

EXCEPTION_POINTERS

GetExceptionInformation

SetErrorMode

SetUnhandledExceptionFilter

Funktionen der strukturierten Ausnahmebehandlung

Übersicht über die strukturierte Ausnahmebehandlung