nf-errhandlingapi-raisefailfastexception.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:errhandlingapi.RaiseFailFastException	RaiseFailFastException function (errhandlingapi.h)	Raises an exception that bypasses all exception handlers (frame or vector based).	FAIL_FAST_GENERATE_EXCEPTION_ADDRESS RaiseFailFastException RaiseFailFastException function base.raisefailfastexception errhandlingapi/RaiseFailFastException	base\raisefailfastexception.htm	Debug	69fbb722-2733-4035-8bfa-a5828311581c	12/05/2018	FAIL_FAST_GENERATE_EXCEPTION_ADDRESS, RaiseFailFastException, RaiseFailFastException function, base.raisefailfastexception, errhandlingapi/RaiseFailFastException	errhandlingapi.h	Windows.h	Windows	Windows 7 [desktop apps \| UWP apps]	Windows Server 2008 R2 [desktop apps \| UWP apps]										Kernel32.lib	Kernel32.dll		Windows			19H1	RaiseFailFastException errhandlingapi/RaiseFailFastException	c++	APIRef kbSyntax	DllExport	Kernel32.dll API-MS-Win-Core-Kernel32-Legacy-l1-1-0.dll kernel32legacy.dll API-MS-Win-Core-Kernel32-Legacy-l1-1-1.dll API-MS-Win-Core-Kernel32-Legacy-l1-1-2.dll API-MS-Win-DownLevel-Kernel32-l2-1-0.dll API-MS-Win-Core-errorhandling-l1-1-2.dll KernelBase.dll MinKernelBase.dll API-MS-Win-Core-ErrorHandling-L1-1-3.dll API-MS-Win-Core-Kernel32-Legacy-L1-1-3.dll API-MS-Win-Core-Kernel32-Legacy-L1-1-4.dll API-MS-Win-Core-Kernel32-Legacy-L1-1-5.dll	RaiseFailFastException

RaiseFailFastException function

-description

Raises an exception that bypasses all exception handlers (frame or vector based). Raising this exception terminates the application and invokes Windows Error Reporting, if Windows Error Reporting is enabled.

-parameters

-param pExceptionRecord [in, optional]

A pointer to an EXCEPTION_RECORD structure that contains the exception information. You must specify the ExceptionAddress and ExceptionCode members.

If this parameter is NULL, the function creates an exception record and sets the ExceptionCode member to STATUS_FAIL_FAST_EXCEPTION. The function will also set the ExceptionAddress member if the dwFlags parameter contains the FAIL_FAST_GENERATE_EXCEPTION_ADDRESS flag.

-param pContextRecord [in, optional]

A pointer to a CONTEXT structure that contains the context information. If NULL, this function generates the context (however, the context will not exactly match the context of the caller).

-param dwFlags [in]

You can specify zero or the following flag that control this function's behavior:

Value	Meaning
FAIL_FAST_GENERATE_EXCEPTION_ADDRESS 0x1	Causes RaiseFailFastException to set the ExceptionAddress of EXCEPTION_RECORD to the return address of this function (the next instruction in the caller after the call to RaiseFailFastException). This function will set the exception address only if ExceptionAddress is not NULL.

-remarks

Typically, you call this function if your application is in a bad state and you want to terminate the application immediately and have a Windows Error Report created.

If the WER service is disabled or cannot be started or there is no debugger attached to the process, the process will be terminated.

This function raises a second chance exception. If JIT debugging is enabled, a debugger will attach to the process.

-see-also

Environment.FailFast