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 |
|---|---|
|
Der Prozess wird gedebuggt, sodass die Ausnahme (als zweite Chance) an den Debugger der Anwendung übergeben werden sollte. |
|
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 |