Export (0) Print
Expand All

WerReportCreate function

Creates a problem report that describes an application event.

Syntax


HRESULT WINAPI WerReportCreate(
  _In_      PCWSTR pwzEventType,
  _In_      WER_REPORT_TYPE repType,
  _In_opt_  PWER_REPORT_INFORMATION pReportInformation,
  _Out_     HREPORT *phReportHandle
);

Parameters

pwzEventType [in]

A pointer to a Unicode string that specifies the name of the event. To register an event that can be used by your application, see About Windows Error Reporting for Software.

repType [in]

The type of report. This parameter can be one of the following values from the WER_REPORT_TYPE enumeration type.

ValueMeaning
WerReportApplicationCrash
2

An error that has caused the application to stop running has occurred.

WerReportApplicationHang
3

An error that has caused the application to stop responding has occurred.

WerReportInvalid
5

An error that has called out a return that is not valid has occurred.

WerReportKernel
4

An error in the kernel has occurred.

WerReportCritical
1

A critical error, such as a crash or non-response, has occurred. By default, processes that experience a critical error are terminated or restarted.

WerReportNonCritical
0

An error that is not critical has occurred. This type of report shows no UI; the report is silently queued. It may then be sent silently to the server in the background if adequate user consent is available.

 

pReportInformation [in, optional]

A pointer to a WER_REPORT_INFORMATION structure that specifies information for the report.

phReportHandle [out]

A handle to the report. If the function fails, this handle is NULL.

Return value

This function returns S_OK on success or an error code on failure.

Remarks

Use the following functions to specify additional information to be submitted:

WerReportAddDump
WerReportAddFile
WerReportSetParameter

To submit the information, call the WerReportSubmit function. When you have finished with the report handle, call the WerReportCloseHandle function.

Applications can also indicate that they would like the opportunity to recover data or restart on failure. For more information, see Application Recovery and Restart.

To view the reports submitted by your application, go to Windows Quality Online Services.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Werapi.h

Library

Wer.lib

DLL

Wer.dll

See also

Application Recovery and Restart
WER Functions
WER_REPORT_INFORMATION
WerReportCloseHandle
WerReportSubmit
Windows Error Reporting

 

 

Community Additions

ADD
Show:
© 2014 Microsoft