Export (0) Print
Expand All

ReportFault function

Enables an application that performs its own exception handling to report faults to Microsoft. Although you can use this function to report application crashes, we recommend that applications not handle fatal errors directly but instead rely on the crash reporting capability provided by the operating system.

Syntax


EFaultRepRetVal APIENTRY ReportFault(
  _In_  LPEXCEPTION_POINTERS pep,
  _In_  DWORD dwMode
);

Parameters

pep [in]

A pointer to an EXCEPTION_POINTERS structure.

dwMode [in]

This parameter is reserved for system use and should be set to zero.

Return value

This function returns one of the following values.

Return codeDescription
frrvErr

The function failed but the error reporting client was launched.

frrvErrNoDW

The error reporting client was unable to launch. The system will perform its default actions, such as displaying the standard exception dialog box and launching the debugger.

frrvErrTimeout

The function timed out.

frrvLaunchDebugger

The function succeeded and the user launched the debugger.

frrvOk

The function succeeded.

frrvOkHeadless

The function succeeded and the error reporting client was launched in silent reporting mode (no UI is used).

frrvOkManifest

The function succeeded and the error reporting client was launched in manifest reporting mode.

frrvOkQueued

The function succeeded and the fault report was queued for later reporting.

 

These return values indicate whether the reporting application was successfully launched. A successful return value does not necessarily indicate that the fault was successfully reported.

Remarks

The exact result of calling this function depends on how the user or system administrator has configured the error reporting system.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

ErrorRep.h

Library

Faultrep.lib

DLL

Faultrep.dll

See also

AddERExcludedApplication
EXCEPTION_POINTERS
WER Functions
Windows Error Reporting

 

 

Community Additions

ADD
Show:
© 2014 Microsoft