RoFailFastWithErrorContext function (roerrorapi.h)

Raises a non-continuable exception in the current process.

Syntax

void RoFailFastWithErrorContext(
  [in] HRESULT hrError
);

Parameters

[in] hrError

The HRESULT associated with the current error. The exception is raised for any value of hrError.

Return value

None

Remarks

The RoFailFastWithErrorContext function raises a non-continuable exception in the current process when an unhandled failure is encountered, which prevents the process from continuing execution in an undefined state.

Call the RoFailFastWithErrorContext function when a failure occurs in a completion delegate for a completed asynchronous operation, or when a failure occurs in an event handler when an event is raised.

The process that calls RoFailFastWithErrorContext is terminated by a call to RaiseFailFastException. The function does not validate the parameters and raises an exception for any value of the inputs.

Call the RoCaptureErrorContext function to save an IRestrictedErrorInfo object that's associated with the current thread. The RoFailFastWithErrorContext function uses this contextual information to report the error call stack to the Windows Error Reporting service (WER), if it's enabled.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header roerrorapi.h
Library RuntimeObject.lib
DLL ComBase.dll

See also

IRestrictedErrorInfo

RaiseFailFastException

RoCaptureErrorContext