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

Статья
08/23/2023

Вызывает исключение, которое обходит все обработчики исключений (на основе кадра или вектора). Вызов этого исключения завершает работу приложения и вызывает отчеты об ошибках Windows, если включена отчеты об ошибках Windows.

Синтаксис

void RaiseFailFastException(
  [in, optional] PEXCEPTION_RECORD pExceptionRecord,
  [in, optional] PCONTEXT          pContextRecord,
  [in]           DWORD             dwFlags
);

Параметры

[in, optional] pExceptionRecord

Указатель на структуру EXCEPTION_RECORD , содержащую сведения об исключении. Необходимо указать элементы ExceptionAddress и ExceptionCode .

Если этот параметр имеет значение NULL, функция создает запись исключения и задает для элемента ExceptionCode значение STATUS_FAIL_FAST_EXCEPTION. Функция также задаст член ExceptionAddress , если параметр dwFlags содержит флаг FAIL_FAST_GENERATE_EXCEPTION_ADDRESS.

[in, optional] pContextRecord

Указатель на структуру CONTEXT , содержащую сведения о контексте. Если значение РАВНО NULL, эта функция создает контекст (однако контекст не будет точно соответствовать контексту вызывающего объекта).

[in] dwFlags

Можно указать нулевой или следующий флаг, который управляет поведением этой функции:

Значение	Значение
FAIL_FAST_GENERATE_EXCEPTION_ADDRESS 0x1	Вызывает исключение RaiseFailFastException для задания ExceptionAddressEXCEPTION_RECORD возвращаемого адреса этой функции (следующая инструкция в вызывающем объекте после вызова RaiseFailFastException). Эта функция задает адрес исключения только в том случае , если ExceptionAddress не имеет значения NULL.

Значение

FAIL_FAST_GENERATE_EXCEPTION_ADDRESS
0x1

Вызывает исключение RaiseFailFastException для задания ExceptionAddressEXCEPTION_RECORD возвращаемого адреса этой функции (следующая инструкция в вызывающем объекте после вызова RaiseFailFastException). Эта функция задает адрес исключения только в том случае , если ExceptionAddress не имеет значения NULL.

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

None

Remarks

Как правило, эта функция вызывается, если приложение находится в плохом состоянии и хотите немедленно завершить работу приложения и создать отчет об ошибках Windows.

Если служба WER отключена или не может быть запущена или к процессу не подключен отладчик, процесс будет завершен.

Эта функция создает исключение второго шанса. Если JIT-отладка включена, отладчик подключится к процессу.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	errhandlingapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

Environment.FailFast

Поделиться через