PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE fungsi panggilan balik (werapi.h)

Artikel
03/03/2024

Pelaporan Galat Windows (WER) memanggil fungsi ini untuk mendapatkan parameter laporan yang secara unik menjelaskan masalah.

Jenis PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE menentukan penunjuk ke fungsi panggilan balik ini. Anda harus menggunakan "OutOfProcessExceptionEventSignatureCallback" sebagai nama fungsi panggilan balik.

Sintaks

PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE PfnWerRuntimeExceptionEventSignature;

HRESULT PfnWerRuntimeExceptionEventSignature(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [in]      DWORD dwIndex,
  [out]     PWSTR pwszName,
  [in, out] PDWORD pchName,
  [out]     PWSTR pwszValue,
  [in, out] PDWORD pchValue
)
{...}

Parameter

[in] pContext

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

[in] pExceptionInformation

Struktur WER_RUNTIME_EXCEPTION_INFORMATION yang berisi informasi pengecualian.

[in] dwIndex

Indeks parameter laporan. Nilai yang valid adalah 0 hingga 9. Panggilan pertama ke fungsi ini harus mengatur indeks ke 0, dan setiap panggilan berturut-turut harus menaikkan nilai indeks secara berurutan.

[out] pwszName

Buffer yang dialokasikan pemanggil yang Anda gunakan untuk menentukan nama parameter.

[in, out] pchName

Ukuran, dalam karakter, dari buffer pwszName . Ukurannya mencakup karakter null-terminating.

[out] pwszValue

Buffer yang dialokasikan penelepon yang Anda gunakan untuk menentukan nilai parameter.

[in, out] pchValue

Ukuran, dalam karakter, dari buffer pwszValue . Ukurannya mencakup karakter null-terminating.

Nilai kembali

Mengembalikan S_OK pada keberhasilan. Jika Anda mengembalikan kode kegagalan lainnya, WER kembali ke perilaku pelaporan crash defaultnya.

Keterangan

Anda harus menerapkan fungsi ini dalam DLL handler pengecualian Anda.

Untuk menghasilkan laporan kesalahan untuk masalah khusus aplikasi, aplikasi harus membuat deskripsi singkat tentang masalah menggunakan beberapa informasi dasar yang disebut parameter laporan. Parameter laporan mencakup informasi seperti nama aplikasi, versi aplikasi, nama modul, versi modul, dan kode kesalahan. Kombinasi parameter laporan ini menjelaskan masalah unik.

WER memanggil fungsi panggilan balik ini hanya jika Anda mengatur parameter pbOwnershipClaimed dari fungsi panggilan balik OutOfProcessExceptionEventCallback Anda ke TRUE. Parameter pdwSignatureCount dari OutOfProcessExceptionEventCallback menentukan berapa kali WER akan memanggil fungsi panggilan balik ini.

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

Bagikan melalui