Функция UnhandledExceptionFilter (errhandlingapi.h)
Определяемая приложением функция, которая передает необработанные исключения в отладчик, если процесс находится в процессе отладки. В противном случае при необходимости отображается окно сообщение об ошибке приложения и вызывается выполнение обработчика исключений. Эту функцию можно вызывать только из выражения фильтра обработчика исключений.
Синтаксис
LONG UnhandledExceptionFilter(
[in] _EXCEPTION_POINTERS *ExceptionInfo
);
Параметры
[in] ExceptionInfo
Указатель на структуру EXCEPTION_POINTERS , указывающую описание исключения и контекст процессора во время исключения. Этот указатель является возвращаемым значением вызова функции GetExceptionInformation .
Возвращаемое значение
Функция возвращает одно из следующих значений.
| Возвращаемый код или значение | Описание |
|---|---|
|
Процесс выполняется отладка, поэтому исключение должно быть передано (как второй шанс) в отладчик приложения. |
|
Если флаг SEM_NOGPFAULTERRORBOX был указан в предыдущем вызове SetErrorMode, окно сообщения об ошибке приложения не отображается. Функция возвращает управление обработчику исключений, который может выполнять любое соответствующее действие. |
Комментарии
Если процесс не выполняется отладка, функция отображает окно сообщения Об ошибке приложения в зависимости от текущего режима ошибок. Поведение по умолчанию — отображение диалогового окна, но его можно отключить, указав SEM_NOGPFAULTERRORBOX в вызове функции SetErrorMode .
Система внутренне использует UnhandledExceptionFilter для обработки исключений, возникающих во время создания процесса и потока.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | errhandlingapi.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |