Fungsi WerReportSubmit (werapi.h)

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