Fungsi WerRegisterFile (werapi.h)

Mendaftarkan file yang akan dikumpulkan ketika Pelaporan Galat Windows (WER) membuat laporan kesalahan.

Sintaks

HRESULT WerRegisterFile(
  [in] PCWSTR                 pwzFile,
  [in] WER_REGISTER_FILE_TYPE regFileType,
  [in] DWORD                  dwFlags
);

Parameter

[in] pwzFile

Jalur lengkap ke file. Panjang maksimum jalur ini adalah MAX_PATH karakter.

[in] regFileType

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

Nilai	Makna
WerRegFileTypeMax
3	Nilai maksimum untuk jenis enumerasi WER_REGISTER_FILE_TYPE .
WerRegFileTypeOther
2	Jenis file lainnya.
WerRegFileTypeUserDocument
1	Dokumen yang digunakan oleh aplikasi pada saat peristiwa. Dokumen ini hanya dikumpulkan jika server Watson memintanya.

[in] dwFlags

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	Secara otomatis menghapus file setelah ditambahkan ke laporan.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
WER_E_INVALID_STATE	Status proses tidak valid. Misalnya, prosesnya dalam mode pemulihan aplikasi.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Jumlah blok memori dan file terdaftar melebihi batas.

Keterangan

File terdaftar ditambahkan ke laporan hanya ketika data tambahan diminta oleh server.

Untuk crash dan non-respons, sistem operasi secara otomatis menyediakan pelaporan kesalahan (Anda tidak perlu memberikan kode pelaporan kesalahan apa pun di aplikasi Anda). Jika Anda menggunakan fungsi ini untuk mendaftarkan file, sistem operasi akan menambahkan file ke laporan kesalahan yang dibuat pada saat crash atau non-respons (file ini ditambahkan selain file yang sudah dikumpulkan sistem operasi).

Untuk pelaporan peristiwa generik, aplikasi harus menggunakan fungsi WerReportAddFile sebagai gantinya. Atau, memanggil fungsi WerReportSubmit dengan bendera WER_SUBMIT_ADD_REGISTERED_DATA akan menyertakan file yang ditambahkan oleh fungsi WerRegisterFile .

Untuk menghapus file dari daftar, panggil fungsi WerUnregisterFile .

Persyaratan

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

Lihat juga

WerUnregisterFile, Pelaporan Galat Windows