Windows Error Reporting

Overview of the Windows Error Reporting technology.

To develop Windows Error Reporting, you need these headers:

For programming guidance for this technology, see:

Enumerations

 
REPORT_STORE_TYPES

Defines the types of Windows Error Reporting (WER) report stores that can be opened.
WER_CONSENT

Defines the possible Windows Error Reporting (WER) user consent states.
WER_DUMP_TYPE

Defines the possible Windows Error Reporting (WER) minidump types.
WER_FILE_TYPE

Defines the possible Windows Error Reporting (WER) file types for the minidump report.
WER_REGISTER_FILE_TYPE

Defines the Windows Error Reporting (WER) file types that can be registered.
WER_REPORT_TYPE

Defines the Windows Error Reporting (WER) report types.
WER_REPORT_UI

Defines the indexes of the Windows Error Reporting (WER) report's customizable UI strings.
WER_SUBMIT_RESULT

Defines the Windows Error Reporting (WER) submission result options.

Functions

 
AddERExcludedApplicationA

Excludes the specified application from error reporting. (ANSI)
AddERExcludedApplicationW

Excludes the specified application from error reporting. (Unicode)
PFN_WER_RUNTIME_EXCEPTION_DEBUGGER_LAUNCH

Windows Error Reporting (WER) calls this function to let you customize the debugger launch options and launch string.
PFN_WER_RUNTIME_EXCEPTION_EVENT

Windows Error Reporting (WER) calls this function to determine whether the exception handler is claiming the crash.
PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE

Windows Error Reporting (WER) calls this function to get the report parameters that uniquely describe the problem.
ReportFault

Enables an application that performs its own exception handling to report faults to Microsoft.
WerAddExcludedApplication

Adds the specified application to the list of applications that are to be excluded from error reporting.
WerFreeString

Frees up the memory used to store a report key string. This should be called after each successive call to WerStoreGetFirstReportKey or WerStoreGetNextReportKey, once the particular report key string has been used and is no longer needed.
WerGetFlags

Retrieves the fault reporting settings for the specified process.
WerRegisterAdditionalProcess

Registers a process to be included in the Windows Error Reporting (WER) report along with the main application process. Optionally specifies a thread within that registered process to get additional data from.
WerRegisterAppLocalDump

Registers a path (relative to the LocalFolder of the packaged application) where a copy should be saved of the diagnostic memory dump that Windows Error Reporting (WER) collects when one of the processes for the application stops responding.
WerRegisterCustomMetadata

Registers app-specific metadata to be collected (in the form of key/value strings) for the Windows Error Reporting (WER) error report.
WerRegisterExcludedMemoryBlock

Marks a memory block (that is normally included by default in error reports) to be excluded from the Windows Error Reporting (WER) error report.
WerRegisterFile

Registers a file to be collected when Windows Error Reporting (WER) creates an error report.
WerRegisterMemoryBlock

Registers a memory block to be collected when Windows Error Reporting (WER) creates an error report.
WerRegisterRuntimeExceptionModule

Registers a custom runtime exception handler that is used to provide custom Windows Error Reporting (WER) for crashes.
WerRemoveExcludedApplication

Removes the specified application from the list of applications that are to be excluded by Windows Error Reporting (WER).
WerReportAddDump

Adds a dump of the specified type to the specified Windows Error Reporting (WER) report.
WerReportAddFile

Adds a file to the specified Windows Error Reporting (WER) report.
WerReportCloseHandle

Closes the specified Windows Error Reporting (WER) report.
WerReportCreate

Creates a Windows Error Reporting (WER) report that describes an application event.
WerReportHang

Initiates "no response" reporting on the specified window.
WerReportSetParameter

Sets the parameters that uniquely identify an event for the specified Windows Error Reporting (WER) report.
WerReportSetUIOption

Sets the user interface options for the specified Windows Error Reporting (WER) report.
WerReportSubmit

Submits the specified Windows Error Reporting (WER) report.
WerSetFlags

Sets the Windows Error Reporting (WER) reporting settings for the current process.
WerSetMaxProcessHoldMilliseconds

Sets the maximum process hold time for Windows Error Reporting (WER), in milliseconds.
WerStoreClose

Closes the collection of stored Windows Error Reporting (WER) reports.
WerStoreGetFirstReportKey

Gets a reference to the first Windows Error Reporting (WER) report in the report store.
WerStoreGetNextReportKey

Gets a reference to the next Windows Error Reporting (WER) report in the error report store.
WerStoreGetReportCount

Gets the number of Windows Error Reporting (WER) reports in the error report store.
WerStoreGetSizeOnDisk

Gets the size of the Windows Error Reporting (WER) error report store, in bytes.
WerStoreOpen

Opens the collection of stored Windows Error Reporting (WER) error reports.
WerStorePurge

Purges the Windows Error Reporting (WER) report store.
WerStoreQueryReportMetadataV1

Retrieves metadata about a Windows Error Reporting (WER) report in the store.
WerStoreQueryReportMetadataV2

Retrieves metadata about a Windows Error Reporting (WER) report in the store.
WerStoreQueryReportMetadataV3

Retrieves metadata about a Windows Error Reporting (WER) report in the store.
WerStoreUploadReport

Uploads a report to the Windows Error Reporting (WER) store.
WerUnregisterAdditionalProcess

Removes a process from the list of additional processes to be included in the Windows Error Reporting (WER) error report.
WerUnregisterAppLocalDump

Cancels the registration that was made by calling the WerRegisterAppLocalDump function to specify that Windows Error Reporting (WER) should save a copy of the diagnostic memory dump that WER collects when one of the processes for the application stops responding.
WerUnregisterCustomMetadata

Removes an item of app-specific metadata being collected during Windows Error Reporting (WER) for the application.
WerUnregisterExcludedMemoryBlock

Removes a memory block that was previously marked as excluded, which will again be included in Windows Error Reporting] (WER) error reports.
WerUnregisterFile

Removes a file from the list of files to be added to Windows Error Reporting (WER) reports generated for the current process.
WerUnregisterMemoryBlock

Removes a memory block from the list of data to be collected during Windows Error Reporting (WER) for the application.
WerUnregisterRuntimeExceptionModule

Removes the registration of the Windows Error Reporting (WER) exception handler.

Structures

 
WER_DUMP_CUSTOM_OPTIONS

Specifies custom Windows Error Reporting (WER) minidump information to be collected by the WerReportAddDump function.
WER_DUMP_CUSTOM_OPTIONS_V2

Specifies custom Windows Error Reporting (WER) minidump information to be collected by the WerReportAddDump function.
WER_DUMP_CUSTOM_OPTIONS_V3

Specifies custom Windows Error Reporting (WER) minidump information to be collected in the background (without pausing the process) by the PssCaptureSnapshot function.
WER_EXCEPTION_INFORMATION

Contains Windows Error Reporting (WER) exception information for the WerReportAddDump function.
WER_REPORT_INFORMATION

Contains Windows Error Reporting (WER) information used by the WerReportCreate function.
WER_REPORT_INFORMATION_V3

Contains Windows Error Reporting (WER) information used by the WerReportCreate function.
WER_REPORT_INFORMATION_V4

Contains Windows Error Reporting] (WER) information used by the WerReportCreate function.
WER_REPORT_INFORMATION_V5

Contains Windows Error Reporting (WER) information used by the WerReportCreate function.
WER_REPORT_METADATA_V1

Contains information about an error report generated by Windows Error Reporting (WER).
WER_REPORT_METADATA_V2

Contains information about an error report generated by Windows Error Reporting (WER).
WER_REPORT_METADATA_V3

Contains information about an error report generated by Windows Error Reporting (WER).
WER_REPORT_PARAMETER

Contains information about an error report parameter generated by Windows Error Reporting (WER).
WER_REPORT_SIGNATURE

Contains information about an error report signature generated by Windows Error Reporting (WER).
WER_RUNTIME_EXCEPTION_INFORMATION

Contains the Windows Error Reporting (WER) exception information used to determine whether you want to claim the crash.