Fungsi WerReportAddFile (werapi.h)

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

Sintaks

HRESULT WerReportAddFile(
  [in] HREPORT       hReportHandle,
  [in] PCWSTR        pwzPath,
  [in] WER_FILE_TYPE repFileType,
  [in] DWORD         dwFileFlags
);

Parameter

[in] hReportHandle

Handel ke laporan. Handel ini dikembalikan oleh fungsi WerReportCreate .

[in] pwzPath

Penunjuk ke string Unicode yang berisi jalur lengkap ke file yang akan ditambahkan. Jalur ini dapat menggunakan variabel lingkungan. Panjang maksimum jalur ini adalah MAX_PATH karakter.

[in] repFileType

Jenis file. Parameter ini bisa menjadi salah satu nilai berikut dari jenis enumerasi WER_FILE_TYPE .

Nilai	Makna
WerFileTypeHeapdump	Minidump yang diperluas yang berisi data tambahan seperti memori proses.
WerFileTypeMicrodump	Minidump terbatas yang hanya berisi jejak tumpukan.
WerFileTypeMinidump	File minidump.
WerFileTypeOther	Jenis file lainnya. File ini akan selalu ditambahkan ke kabin (tetapi hanya jika server meminta taksi).
WerFileTypeUserDocument	Dokumen yang digunakan oleh aplikasi pada saat peristiwa. Dokumen ditambahkan hanya jika server meminta tipe dokumen ini.

[in] dwFileFlags

Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
WER_FILE_ANONYMOUS_DATA	File tidak berisi informasi pribadi yang dapat digunakan untuk mengidentifikasi atau menghubungi pengguna.
WER_FILE_DELETE_WHEN_DONE	Hapus file secara otomatis setelah laporan dikirimkan.

Nilai kembali

Fungsi ini mengembalikan S_OK pada keberhasilan atau kode kesalahan saat gagal, termasuk kode kesalahan berikut.

Menampilkan kode	Deskripsi
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	File yang ditentukan tidak ada.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	File yang ditentukan adalah dokumen pengguna dan disimpan pada sistem file terenkripsi; kombinasi ini tidak didukung.

Keterangan

Meskipun fungsi ini juga dapat digunakan untuk menambahkan cadangan memori (menggunakan bendera tertentu) ke laporan kesalahan, fungsi yang lebih disukai untuk digunakan untuk menambahkan cadangan memori adalah WerReportAddDump. Anda harus menggunakan fungsi ini hanya jika Anda ingin mengumpulkan cadangan sendiri lalu menambahkannya ke laporan.

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

WerReportCreate, Pelaporan Galat Windows