PFN_WER_RUNTIME_EXCEPTION_EVENT fungsi panggilan balik (werapi.h)

Pelaporan Galat Windows (WER) memanggil fungsi ini untuk menentukan apakah handler pengecualian mengklaim crash.

Jenis PFN_WER_RUNTIME_EXCEPTION_EVENT menentukan penunjuk ke fungsi panggilan balik ini. Anda harus menggunakan "OutOfProcessExceptionEventCallback" sebagai nama fungsi panggilan balik.

Sintaks

PFN_WER_RUNTIME_EXCEPTION_EVENT PfnWerRuntimeExceptionEvent;

HRESULT PfnWerRuntimeExceptionEvent(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [out]     BOOL *pbOwnershipClaimed,
  [out]     PWSTR pwszEventName,
  [in, out] PDWORD pchSize,
  [out]     PDWORD pdwSignatureCount
)
{...}

Parameter

[in] pContext

Penunjuk ke informasi konteks arbitrer yang Anda tentukan saat Anda memanggil fungsi WerRegisterRuntimeExceptionModule untuk mendaftarkan penangan pengecualian.

[in] pExceptionInformation

Struktur WER_RUNTIME_EXCEPTION_INFORMATION yang berisi informasi pengecualian. Gunakan informasi untuk menentukan apakah Anda ingin mengklaim crash.

[out] pbOwnershipClaimed

Atur ke TRUE jika handler pengecualian mengklaim crash ini; jika tidak, FALSE. Jika Anda mengatur parameter ini ke FALSE, jangan atur parameter keluar lainnya.

[out] pwszEventName

Buffer yang dialokasikan penelepon yang Anda gunakan untuk menentukan nama peristiwa yang digunakan untuk mengidentifikasi crash ini.

[in, out] pchSize

Ukuran, dalam karakter, dari buffer pwszEventName . Buffer terbatas pada karakter MAX_PATH. Ukurannya mencakup karakter null-terminating.

[out] pdwSignatureCount

Jumlah parameter laporan yang akan Anda berikan. Rentang nilai yang valid adalah satu hingga 10. Jika Anda menentukan nilai yang lebih besar dari 10, WER akan mengabaikan nilai dan hanya mengumpulkan 10 parameter pertama. Jika Anda menentukan nol, proses pelaporan tidak akan ditentukan.

Nilai ini menentukan berapa kali WER memanggil fungsi OutOfProcessExceptionEventSignatureCallback Anda.

Nilai kembali

Kembalikan S_OK, meskipun handler pengecualian tidak mengklaim crash ini. Jika Anda mengembalikan kode kegagalan lainnya, WER kembali ke perilaku pelaporan crash defaultnya jika tidak ada penangan lain yang terdaftar.

Keterangan

Anda harus menerapkan fungsi ini di DLL penangan pengecualian Anda.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	werapi.h

Lihat juga

WerRegisterRuntimeExceptionModule, Pelaporan Galat Windows