SetUnhandledExceptionFilter 函数 (errhandlingapi.h)

使应用程序能够取代进程每个线程的顶级异常处理程序。

调用此函数后，如果在未调试的进程中发生异常，并且异常会将其引入未经处理的异常筛选器，该筛选器将调用 由 lpTopLevelExceptionFilter 参数指定的异常筛选器函数。

语法

LPTOP_LEVEL_EXCEPTION_FILTER SetUnhandledExceptionFilter(
  [in] LPTOP_LEVEL_EXCEPTION_FILTER lpTopLevelExceptionFilter
);

[in] lpTopLevelExceptionFilter

指向顶级异常筛选器函数的指针，每当 UnhandledExceptionFilter 函数获得控制权且进程未调试时，将调用该函数。此参数的 NULL 值指定 UnhandledExceptionFilter 中的默认处理。

filter 函数的语法类似于 UnhandledExceptionFilter：它采用 LPEXCEPTION_POINTERS 类型的单个参数，具有 WINAPI 调用约定，并返回 LONG 类型的值。筛选器函数应返回以下值之一。

值	含义
EXCEPTION_EXECUTE_HANDLER 0x1	从 UnhandledExceptionFilter 返回并执行关联的异常处理程序。这通常会导致进程终止。
EXCEPTION_CONTINUE_EXECUTION 0xffffffff	从 UnhandledExceptionFilter 返回，并从异常点继续执行。请注意，筛选器函数可以通过修改通过其 LPEXCEPTION_POINTERS 参数提供的异常信息来自由修改延续状态。
EXCEPTION_CONTINUE_SEARCH 0x0	继续正常执行 UnhandledExceptionFilter。这意味着遵守 SetErrorMode 标志，或调用“应用程序错误”弹出消息框。

SetUnhandledExceptionFilter 函数返回使用函数建立的上一个异常筛选器的地址。 NULL 返回值表示当前没有顶级异常处理程序。

发出 SetUnhandledExceptionFilter 将替换调用进程中所有现有线程和所有未来线程的现有顶级异常筛选器。

lpTopLevelExceptionFilter 指定的异常处理程序在导致错误的线程上下文中执行。这可能会影响异常处理程序从某些异常（如无效堆栈）中恢复的能力。


最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	errhandlingapi.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll