werReportAddDump 函数 (werapi.h)

  • 项目

将指定类型的转储添加到指定的Windows 错误报告 (WER) 报表。

语法

HRESULT WerReportAddDump(
  [in]           HREPORT                    hReportHandle,
  [in]           HANDLE                     hProcess,
  [in, optional] HANDLE                     hThread,
  [in]           WER_DUMP_TYPE              dumpType,
  [in, optional] PWER_EXCEPTION_INFORMATION pExceptionParam,
  [in, optional] PWER_DUMP_CUSTOM_OPTIONS   pDumpCustomOptions,
  [in]           DWORD                      dwFlags
);

参数

[in] hReportHandle

报表的句柄。 此句柄由 WerReportCreate 函数返回。

[in] hProcess

正在为其生成报表的进程句柄。 此句柄必须具有STANDARD_RIGHTS_READ和PROCESS_QUERY_INFORMATION访问权限。

[in, optional] hThread

要为其生成报表的 hProcess 线程的句柄。 如果 dumpType 为 WerDumpTypeMicro，则此参数是必需的。 对于其他转储类型，此参数可能为 NULL。

[in] dumpType

小型转储的类型。 此参数可以是 WER_DUMP_TYPE 枚举类型的下列值之一。

值 含义
WerDumpTypeHeapDump
 包含其他数据（如进程内存）的扩展小型转储。

此类型等效于使用以下选项创建小型转储：

  • MiniDumpWithDataSegs
  • MiniDumpWithProcessThreadData
  • MiniDumpWithHandleData
  • MiniDumpWithPrivateReadWriteMemory
  • MiniDumpWithUnloadedModules
  • MiniDumpWithFullMemoryInfo
  • MiniDumpWithThreadInfo (Windows 7 及更高版本)
  • MiniDumpWithTokenInformation (Windows 7 及更高版本)
  • MiniDumpWithPrivateWriteCopyMemory (Windows 7 及更高版本)
WerDumpTypeMicroDump
 仅包含堆栈跟踪的有限小型转储。

此类型等效于使用以下选项创建小型转储：

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithoutOptionalData
WerDumpTypeMiniDump
 小型转储。

此类型等效于使用以下选项创建小型转储：

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithTokenInformation (Windows 7 及更高版本)

[in, optional] pExceptionParam

指向指定异常信息的 WER_EXCEPTION_INFORMATION 结构的指针。

[in, optional] pDumpCustomOptions

指向指定自定义小型转储选项 的WER_DUMP_CUSTOM_OPTIONS 结构的指针。 如果此参数为 NULL，则收集标准小型转储信息。

[in] dwFlags

此参数可以是 0 或以下值。

值 含义
WER_DUMP_NOHEAP_ONQUEUE
 如果报表正在排队，请不要包含堆转储。 使用此标志可节省磁盘空间。

返回值

此函数在成功 时返回S_OK 或失败时返回错误代码。

注解

此函数仅用于通用报告，它不会影响操作系统崩溃或无响应报告。

如果服务器请求小型转储，并且你为 dumpType 参数指定了 WerDumpTypeHeapDump，则 WER 不会将堆转储发送到 Watson 服务器。 但是，如果服务器请求堆转储，并且 dumpType 为 WerDumpTypeMiniDump，则 WER 会将小型转储发送到服务器。 因此，建议将 dumpType 设置为 WerDumpTypeMiniDump。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 werapi.h
Library Wer.lib
DLL Wer.dll

另请参阅

小型转储文件、WER_DUMP_CUSTOM_OPTIONS、WER_EXCEPTION_INFORMATION、WerReportCreate、Windows 错误报告