UnhandledExceptionFilter

UnhandledExceptionFilter 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 a try-except exception handler.

Syntax

LONG UnhandledExceptionFilter(
    STRUCT_EXCEPTION_POINTERS * ExceptionInfo
);

Parameters

ExceptionInfo

A pointer to an EXCEPTION_POINTERS structure containing 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:

EXCEPTION_CONTINUE_SEARCH — Control returns to the default system exception handler, which terminates the process.
EXCEPTION_EXECUTE_HANDLER — Control returns to the exception handler, which is free to take any appropriate action.

Remarks

The function displays an Application Error message box. When a thread of a multi-threaded RTSS process causes an exception, RTSS freezes (or unloads, if so configured) all threads of a process and produces an Application Error message box. The default behavior of Win32 is somewhat different. In Win32, until the user responds to the box, other threads of the Win32 process continue running. When the user has responded, all threads of the Win32 process terminate.

Requirements

Minimum Supported Version	RTX64 2013
Header	windows.h
Library	rtapi.lib (Windows), Rtx_Rtss.lib (RTSS)