werReportCreate 函数 (werapi.h)
创建描述应用程序事件的Windows 错误报告 (WER) 报表。
语法
HRESULT WerReportCreate(
[in] PCWSTR pwzEventType,
[in] WER_REPORT_TYPE repType,
[in, optional] PWER_REPORT_INFORMATION pReportInformation,
[out] HREPORT *phReportHandle
);
参数
[in] pwzEventType
指向 Unicode 字符串的指针,该字符串指定事件的名称。
[in] repType
报表的类型。 此参数可以是 WER_REPORT_TYPE 枚举类型中的下列值之一。
值 | 含义 |
---|---|
WerReportApplicationCrash 2 |
发生了导致应用程序停止运行的错误。 |
WerReportApplicationHang 3 |
发生了导致应用程序停止响应的错误。 |
WerReportInvalid 5 |
发生了一个错误,该错误调用了无效的返回。 |
WerReportKernel 4 |
内核中发生错误。 |
WerReportCritical 1 |
发生了严重错误,例如崩溃或无响应。 默认情况下,遇到严重错误的进程会终止或重新启动。 |
WerReportNonCritical 0 |
发生了不重要的错误。 此类型的报表不显示 UI;报表以无提示方式排队。 然后,如果有足够的用户同意,则可以在后台以无提示方式将其发送到服务器。 |
[in, optional] pReportInformation
指向 WER_REPORT_INFORMATION 结构的指针,该结构指定报表的信息。
[out] phReportHandle
报表的句柄。 如果函数失败,则此句柄为 NULL。
返回值
此函数在成功时返回 S_OK 或失败时返回错误代码。
注解
使用以下函数指定要提交的附加信息:
若要提交信息,请调用 WerReportSubmit 函数。 完成报表句柄后,调用 WerReportCloseHandle 函数。
应用程序还可以指示他们希望有机会恢复数据或在失败时重启。 有关详细信息,请参阅 应用程序恢复和重启。
若要查看应用程序提交的报表,请转到 Windows 质量在线服务。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | werapi.h |
Library | Wer.lib |
DLL | Wer.dll |
另请参阅
应用程序恢复和重启、WER_REPORT_INFORMATION、WerReportCloseHandle、WerReportSubmitWindows 错误报告