ReportFault function (errorrep.h)
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 ReportFault(
[in] LPEXCEPTION_POINTERS pep,
[in] DWORD dwOpt
);
Parameters
[in] pep
A pointer to an EXCEPTION_POINTERS structure.
[in] dwOpt
This parameter is reserved for system use and should be set to zero.
Return value
This function returns one of the following values.
| Return code | Description |
|---|---|
|
The function failed but the error reporting client was launched. |
|
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. |
|
The function timed out. |
|
The function succeeded and the user launched the debugger. |
|
The function succeeded. |
|
The function succeeded and the error reporting client was launched in silent reporting mode (no UI is used). |
|
The function succeeded and the error reporting client was launched in manifest reporting mode. |
|
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | errorrep.h |
| Library | Faultrep.lib |
| DLL | Faultrep.dll |