Bagikan melalui

Fungsi WerReportAddDump (werapi.h)

  • Artikel

Menambahkan cadangan jenis yang ditentukan ke laporan Pelaporan Galat Windows (WER) yang ditentukan.

Sintaks

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
);

Parameter

[in] hReportHandle

Handel ke laporan. Handel ini dikembalikan oleh fungsi WerReportCreate .

[in] hProcess

Handel ke proses yang laporannya sedang dibuat. Handel ini harus memiliki hak akses STANDARD_RIGHTS_READ dan PROCESS_QUERY_INFORMATION.

[in, optional] hThread

Handel ke utas hProcess tempat laporan dibuat. Jika dumpType adalah WerDumpTypeMicro, parameter ini diperlukan. Untuk jenis cadangan lainnya, parameter ini mungkin NULL.

[in] dumpType

Jenis minidump. Parameter ini bisa menjadi salah satu nilai berikut dari jenis enumerasi WER_DUMP_TYPE .

Nilai Makna
WerDumpTypeHeapDump
 Minidump yang diperluas yang berisi data tambahan seperti memori proses.

Jenis ini setara dengan membuat minidump dengan opsi berikut:

  • MiniDumpWithDataSegs
  • MiniDumpWithProcessThreadData
  • MiniDumpWithHandleData
  • MiniDumpWithPrivateReadWriteMemory
  • MiniDumpWithUnloadedModules
  • MiniDumpWithFullMemoryInfo
  • MiniDumpWithThreadInfo (Windows 7 dan yang lebih baru)
  • MiniDumpWithTokenInformation (Windows 7 dan yang lebih baru)
  • MiniDumpWithPrivateWriteCopyMemory (Windows 7 dan yang lebih baru)
WerDumpTypeMicroDump
 Minidump terbatas yang hanya berisi jejak tumpukan.

Jenis ini setara dengan membuat minidump dengan opsi berikut:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithoutOptionalData
WerDumpTypeMiniDump
 Sebuah minidump.

Jenis ini setara dengan membuat minidump dengan opsi berikut:

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithTokenInformation (Windows 7 dan yang lebih baru)

[in, optional] pExceptionParam

Penunjuk ke struktur WER_EXCEPTION_INFORMATION yang menentukan informasi pengecualian.

[in, optional] pDumpCustomOptions

Penunjuk ke struktur WER_DUMP_CUSTOM_OPTIONS yang menentukan opsi minidump kustom. Jika parameter ini NULL, informasi minidump standar dikumpulkan.

[in] dwFlags

Parameter ini bisa 0 atau nilai berikut.

Nilai Makna
WER_DUMP_NOHEAP_ONQUEUE
 Jika laporan sedang diantrekan, jangan sertakan heap dump. Menggunakan bendera ini menghemat ruang disk.

Nilai kembali

Fungsi ini mengembalikan S_OK pada keberhasilan atau kode kesalahan pada kegagalan.

Keterangan

Gunakan fungsi ini hanya untuk pelaporan generik—tidak berpengaruh pada crash sistem operasi atau pelaporan tanpa respons.

Jika server meminta cadangan mini dan Anda menentukan WerDumpTypeHeapDump untuk parameter dumpType , WER tidak akan mengirim heap dump ke server Watson. Namun, jika server meminta heap dump dan dumpType adalah WerDumpTypeMiniDump, WER akan mengirim cadangan mini ke server. Dengan demikian, disarankan agar Anda mengatur dumpType ke WerDumpTypeMiniDump.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header werapi.h
Pustaka Wer.lib
DLL Wer.dll

Lihat juga

File Minidump, WER_DUMP_CUSTOM_OPTIONS, WER_EXCEPTION_INFORMATION, WerReportCreate, Pelaporan Galat Windows