Bagikan melalui

Fungsi WerReportSubmit (werapi.h)

  • Artikel

Mengirimkan laporan Pelaporan Galat Windows (WER) yang ditentukan.

Sintaks

HRESULT WerReportSubmit(
  [in]            HREPORT            hReportHandle,
  [in]            WER_CONSENT        consent,
  [in]            DWORD              dwFlags,
  [out, optional] PWER_SUBMIT_RESULT pSubmitResult
);

Parameter

[in] hReportHandle

Handel ke laporan. Handel ini dikembalikan oleh fungsi WerReportCreate .

[in] consent

Status persetujuan. Parameter ini bisa menjadi salah satu nilai berikut dari jenis enumerasi WER_CONSENT .

Nilai Makna
WerConsentAlwaysPrompt
4		 Pengguna selalu diminta untuk mengirimkan permintaan.
WerConsentApproved
2		 Pengguna telah menyetujui permintaan pengiriman.
WerConsentDenied
3		 Pengguna telah menolak permintaan pengiriman.
WerConsentMax
5		 Nilai maksimum untuk jenis enumerasi WER_CONSENT .
WerConsentNotAsked
1		 Pengguna tidak dimintai persetujuan.

[in] dwFlags

Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai Makna
WER_SUBMIT_ADD_REGISTERED_DATA
16		 Tambahkan data yang didaftarkan oleh WerSetFlags, WerRegisterFile, dan WerRegisterMemoryBlock ke laporan.
WER_SUBMIT_HONOR_RECOVERY
1		 Hormati pendaftaran pemulihan apa pun untuk aplikasi. Untuk informasi selengkapnya, lihat RegisterApplicationRecoveryCallback.
WER_SUBMIT_HONOR_RESTART
2		 Hormati pendaftaran hidupkan ulang apa pun untuk aplikasi. Untuk informasi selengkapnya, lihat RegisterApplicationRestart.
WER_SUBMIT_NO_ARCHIVE
256		 Jangan mengarsipkan laporan.
WER_SUBMIT_NO_CLOSE_UI
64		 Jangan tampilkan kotak dialog tutup untuk laporan penting.
WER_SUBMIT_NO_QUEUE
128		 Jangan mengantre laporan. Jika ada persetujuan pengguna yang memadai, laporan akan segera dikirim ke Microsoft; jika tidak, laporan akan dibuang. Anda dapat menggunakan bendera ini untuk laporan yang tidak penting.

Laporan dibuang untuk tindakan apa pun yang akan mengharuskan laporan diantrekan. Misalnya, jika komputer offline saat Anda mengirimkan laporan, laporan akan dibuang. Selain itu, jika ada persetujuan yang tidak mencukup (misalnya, persetujuan diperlukan untuk bagian data laporan), laporan akan dibuang.
WER_SUBMIT_OUTOFPROCESS
32		 Menelurkan proses lain untuk mengirimkan laporan. Utas panggilan diblokir hingga fungsi kembali.

CATATAN: Pesan jendela akan dipompa sehingga aktivitas UI pada utas panggilan tidak diblokir.
WER_SUBMIT_OUTOFPROCESS_ASYNC
1024		 Menelurkan proses lain untuk segera mengirimkan laporan dan kembali dari panggilan fungsi ini. Perhatikan bahwa konten parameter pSubmitResult tidak terdefinisi dan tidak ada cara untuk mengkueri saat pelaporan selesai atau status penyelesaian.
WER_SUBMIT_QUEUE
4		 Tambahkan laporan ke antrean WER tanpa memberi tahu pengguna. Laporan hanya diantrekan—pelaporan (pengiriman laporan ke Microsoft) terjadi nanti berdasarkan tingkat persetujuan pengguna.
WER_SUBMIT_SHOW_DEBUG
8		 Tampilkan tombol debug.
WER_SUBMIT_START_MINIMIZED
512		 UI awal diminimalkan dan berkedip.
WER_SUBMIT_BYPASS_DATA_THROTTLING
2048		 Melewati pembatasan data untuk laporan.

Windows 7 atau yang lebih lama: Parameter ini tidak tersedia.
WER_SUBMIT_ARCHIVE_PARAMETERS_ONLY
4096		 Arsipkan hanya parameter; kabin dibuang. Bendera ini mengambil alih pengaturan ConfigureArchive WER.

Windows 7 atau yang lebih lama: Parameter ini tidak tersedia.
WER_SUBMIT_REPORT_MACHINE_ID
8192		 Selalu kirim pengidentifikasi komputer unik 128-bit dengan laporan, terlepas dari persetujuan yang laporannya dikirimkan. Lihat Keterangan untuk informasi tambahan.

Windows 7 atau yang lebih lama: Parameter ini tidak tersedia.

[out, optional] pSubmitResult

Hasil dari pengajuan. Parameter ini bisa menjadi salah satu nilai berikut dari jenis enumerasi WER_SUBMIT_RESULT .

Nilai Makna
WerCustomAction
9		 Pelaporan kesalahan dapat disesuaikan.
WerDisabled
5		 Pelaporan kesalahan dinonaktifkan.
WerDisabledQueue
7		 Antrean dinonaktifkan.
WerReportAsync
8		 Laporan ini tidak sinkron.
WerReportCancelled
6		 Laporan dibatalkan.
WerReportDebug
3		 Tombol Debug diklik.
WerReportFailed
4		 Pengiriman laporan gagal.
WerReportQueued
1		 Laporannya diantrekan.
WerReportUploaded
2		 Laporan diunggah.

Nilai kembali

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

Keterangan

Setelah aplikasi memanggil fungsi ini, WER mengumpulkan data yang ditentukan. Jika parameter persetujuan adalah WerConsentApproved, parameter tersebut akan mengirimkan laporan ke Microsoft. Jika persetujuan adalah WerConsentNotAsked, WER menampilkan kotak dialog persetujuan. Untuk menentukan status pengiriman, periksa parameter pSubmitResult .

Jika terjadi peristiwa aplikasi penting, aplikasi yang telah terdaftar untuk memulai ulang akan dimulai ulang.

Pengidentifikasi komputer dikirim dengan laporan ketika:

  • Persetujuan yang digunakan untuk mengirim laporan tidak berasal dari aplikasi. Misalnya, laporan dikirimkan dengan status persetujuan yang diatur ke WerConsentNotAsked.
  • Laporan dikirimkan dengan set bendera WER_SUBMIT_REPORT_MACHINE_ID.

Untuk melihat laporan yang dikirimkan oleh aplikasi Anda, buka Layanan Online Kualitas Windows.

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

Pemulihan dan Mulai Ulang Aplikasi, WerReportCreate, Pelaporan Galat Windows