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

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

Синтаксис

LONG UnhandledExceptionFilter(
  [in] _EXCEPTION_POINTERS *ExceptionInfo
);

Параметры

[in] ExceptionInfo

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

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

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

Возвращаемый код или значение	Описание
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

См. также

EXCEPTION_POINTERS

GetExceptionInformation

SetErrorMode

SetUnhandledExceptionFilter

Структурированные функции обработки исключений

Общие сведения о структурированной обработке исключений