An application-defined function that passes unhandled exceptions to the debugger, if the process is being debugged. Otherwise, it optionally displays an Application Error message box and causes the exception handler to be executed. This function can be called only from within the filter expression of an exception handler.
Syntax
LONG WINAPI UnhandledExceptionFilter(
__in struct _EXCEPTION_POINTERS *ExceptionInfo
);
Parameters
- ExceptionInfo [in]
-
A pointer to an
EXCEPTION_POINTERS structure that specifies a description of the exception and the processor context at the time of the exception. This pointer is the return value of a call to the
GetExceptionInformation function.
Return Value
The function returns one of the following values.
| Return code/value | Description |
|---|
- EXCEPTION_CONTINUE_SEARCH
- 0x0
| The process is being debugged, so the exception should be passed (as second chance) to the application's debugger.
|
- EXCEPTION_EXECUTE_HANDLER
- 0x1
| If the SEM_NOGPFAULTERRORBOX flag was specified in a previous call to
SetErrorMode, no Application Error message box is displayed. The function returns control to the exception handler, which is free to take any appropriate action.
|
Remarks
If the process is not being debugged, the function displays an Application Error message box, depending on the current error mode. The default behavior is to display the dialog box, but this can be disabled by specifying SEM_NOGPFAULTERRORBOX in a call to the
SetErrorMode function.
The system uses
UnhandledExceptionFilter internally to handle exceptions that occur during process and thread creation.
Requirements
| Minimum supported client | Windows 2000 Professional |
|---|
| Minimum supported server | Windows 2000 Server |
|---|
| Header | Winbase.h (include Windows.h) |
|---|
| Library | Kernel32.lib |
|---|
| DLL | Kernel32.dll |
|---|
See Also
- EXCEPTION_POINTERS
- GetExceptionInformation
- SetErrorMode
- SetUnhandledExceptionFilter
- Structured Exception Handling Functions
- Structured Exception Handling Overview
Send comments about this topic to Microsoft
Build date: 11/12/2009