Функция UnhandledExceptionFilter (errhandlingapi.h)

Статья
08/23/2023

Определяемая приложением функция, которая передает необработанные исключения в отладчик, если процесс находится в процессе отладки. В противном случае при необходимости отображается окно сообщение об ошибке приложения и вызывается выполнение обработчика исключений. Эту функцию можно вызывать только из выражения фильтра обработчика исключений.

Синтаксис

LONG UnhandledExceptionFilter(
  [in] _EXCEPTION_POINTERS *ExceptionInfo
);

Параметры

[in] ExceptionInfo

Указатель на структуру EXCEPTION_POINTERS , указывающую описание исключения и контекст процессора во время исключения. Этот указатель является возвращаемым значением вызова функции GetExceptionInformation .

Возвращаемое значение

Функция возвращает одно из следующих значений.

Возвращаемый код или значение	Описание
EXCEPTION_CONTINUE_SEARCH 0x0	Процесс выполняется отладка, поэтому исключение должно быть передано (как второй шанс) в отладчик приложения.
EXCEPTION_EXECUTE_HANDLER 0x1	Если флаг SEM_NOGPFAULTERRORBOX был указан в предыдущем вызове SetErrorMode, окно сообщения об ошибке приложения не отображается. Функция возвращает управление обработчику исключений, который может выполнять любое соответствующее действие.

Возвращаемый код или значение

Описание

EXCEPTION_CONTINUE_SEARCH
0x0

Процесс выполняется отладка, поэтому исключение должно быть передано (как второй шанс) в отладчик приложения.

EXCEPTION_EXECUTE_HANDLER
0x1

Если флаг SEM_NOGPFAULTERRORBOX был указан в предыдущем вызове SetErrorMode, окно сообщения об ошибке приложения не отображается. Функция возвращает управление обработчику исключений, который может выполнять любое соответствующее действие.

Если процесс не выполняется отладка, функция отображает окно сообщения Об ошибке приложения в зависимости от текущего режима ошибок. Поведение по умолчанию — отображение диалогового окна, но его можно отключить, указав SEM_NOGPFAULTERRORBOX в вызове функции SetErrorMode .

Система внутренне использует UnhandledExceptionFilter для обработки исключений, возникающих во время создания процесса и потока.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	errhandlingapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll