WER Functions

The following functions are used in Windows Error Reporting. For examples that use these functions, see samples in the Windows SDK under WinBase\WindowsErrorReporting and WinBase\Debug\FailFast.

In this section

Topic Description
AddERExcludedApplication
Excludes the specified application from error reporting.
PFN_WER_RUNTIME_EXCEPTION_EVENT
WER calls this function to determine whether the exception handler is claiming the crash.
PFN_WER_RUNTIME_EXCEPTION_DEBUGGER_LAUNCH
WER calls this function to let you customize the debugger launch options and launch string.
PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE
WER can call this function multiple times 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 error 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 local app store for the calling application where 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.
WerRegisterCustomMetadata
Registers app-specific metadata to be collected (in the form of key/value strings) when WER creates an error report.
WerRegisterExcludedMemoryBlock
Marks a memory block (that is normally included by default in error reports) to be excluded from the error report.
WerRegisterFile
Registers a file to be collected when WER creates an error report.
WerRegisterMemoryBlock
Registers a memory block to be collected when WER creates an error report.
WerRegisterRuntimeExceptionModule
Registers a custom runtime exception handler that is used to provide custom error reporting for crashes.
WerRemoveExcludedApplication
Removes the specified application from the list of applications that are to be excluded from error reporting.
WerReportAddDump
Adds a dump of the specified type to the specified report.
WerReportAddFile
Adds a file to the specified report.
WerReportCloseHandle
Closes the specified report.
WerReportCreate
Creates a problem 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 report.
WerReportSetUIOption
Sets the user interface options for the specified report.
WerReportSubmit
Submits the specified report.
WerSetFlags
Sets the fault reporting settings for the current process.
WerStoreClose
Closes the collection of stored reports.
WerStoreGetFirstReportKey
Gets a reference to the first report in the report store.
WerStoreGetNextReportKey
Gets a reference to the next report in the error report store.
WerStoreOpen
Opens the collection of stored error reports.
WerStoreQueryReportMetadataV2
Retrieves metadata about a report in the store.
WerUnregisterAdditionalProcess
Removes a process from the list of additional processes to be included in the 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 error reporting for the application.
WerUnregisterExcludedMemoryBlock
Removes a memory block that was previously marked as excluded (it will again be included in error reports).
WerUnregisterFile
Removes a file from the list of files to be added to reports generated for the current process.
WerUnregisterMemoryBlock
Removes a memory block from the list of data to be collected during error reporting for the application.
WerUnregisterRuntimeExceptionModule
Removes the registration of your WER exception handler.

Obsolete Functions

The following functions are obsolete and are provided only for compatibility: