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
程式庫 Wer.lib
Dll Wer.dll

另請參閱

Minidump Files、WER_DUMP_CUSTOM_OPTIONS、WER_EXCEPTION_INFORMATION、WerReportCreate、Windows 錯誤報告