Export (0) Print
Expand All
Expand Minimize

RoFailFastWithErrorContext function

Raises a non-continuable exception in the current process.

Syntax


void WINAPI RoFailFastWithErrorContext(
  _In_  HRESULT hrError
);

Parameters

hrError [in]

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

Return value

This function does not return a value.

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.

Windows Phone 8: This API is supported.

Windows Phone 8.1: This API is supported.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

Roerrorapi.h

See also

IRestrictedErrorInfo
RoCaptureErrorContext
RaiseFailFastException

 

 

Community Additions

ADD
Show:
© 2014 Microsoft