PFN_WER_RUNTIME_EXCEPTION_DEBUGGER_LAUNCH fungsi panggilan balik (werapi.h)

Pelaporan Galat Windows (WER) memanggil fungsi ini untuk memungkinkan Anda menyesuaikan opsi peluncuran debugger dan meluncurkan string.

Jenis PFN_WER_RUNTIME_EXCEPTION_DEBUGGER_LAUNCH menentukan penunjuk ke fungsi panggilan balik ini. Anda harus menggunakan "OutOfProcessExceptionEventDebuggerLaunchCallback" sebagai nama fungsi panggilan balik.

Sintaks

PFN_WER_RUNTIME_EXCEPTION_DEBUGGER_LAUNCH PfnWerRuntimeExceptionDebuggerLaunch;

HRESULT PfnWerRuntimeExceptionDebuggerLaunch(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [out]     PBOOL pbIsCustomDebugger,
  [out]     PWSTR pwszDebuggerLaunch,
  [in, out] PDWORD pchDebuggerLaunch,
  [out]     PBOOL pbIsDebuggerAutolaunch
)
{...}

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.

[out] pbIsCustomDebugger

Atur ke TRUE jika debugger kustom yang ditentukan dalam parameter pwszDebuggerLaunch digunakan untuk men-debug crash; jika tidak, atur ke FALSE untuk menggunakan debugger default. Jika Anda mengatur parameter ini ke FALSE, jangan atur parameter pwszDebuggerLaunch .

[out] pwszDebuggerLaunch

Buffer yang dialokasikan penelepon yang Anda gunakan untuk menentukan string peluncuran debugger yang digunakan untuk meluncurkan debugger. String peluncuran harus menyertakan jalur lengkap ke debugger dan argumen apa pun. Jika argumen menyertakan beberapa kata, gunakan tanda kutip untuk memisahkan argumen. String debugger harus mematuhi protokol yang sama dengan string debugger AeDebug default (lihat Mengonfigurasi Debugging Otomatis). String harus berisi dua penentu pemformatan: %ld untuk ID proses yang mengalami crash, dan %ld untuk handel ke objek kejadian yang akan disinyalkan setelah debugger kustom dilampirkan ke target (untuk deskripsi penentu ini, lihat Mengaktifkan Debugging Postmortem). Namun, debugger kustom dapat memilih untuk mengabaikan parameter ini.

[in, out] pchDebuggerLaunch

Ukuran, dalam karakter, dari buffer pwszDebuggerLaunch .

[out] pbIsDebuggerAutolaunch

Atur ke TRUE jika Anda ingin WER meluncurkan debugger secara diam-diam; jika tidak, FALSE jika Anda ingin WER bertanya kepada pengguna sebelum meluncurkan debugger.

Mengembalikan nilai

Kembalikan S_OK, meskipun tidak ada debugger pelanggan yang akan digunakan. Jika Anda mengembalikan kode kegagalan lainnya, WER kembali ke perilaku pelaporan crash defaultnya.

Keterangan

Anda harus menerapkan fungsi ini dalam DLL handler pengecualian Anda.

WER menggunakan fungsi ini untuk menentukan debugger mana yang akan diluncurkan dan apakah akan meluncurkan debugger secara otomatis atau bertanya kepada pengguna sebelum meluncurkan debugger. Menentukan debugger kustom akan menggantikan string peluncuran default (kunci registri AeDebug berisi string peluncuran default).

WER memanggil fungsi panggilan balik ini hanya jika Anda mengatur parameter pbOwnershipClaimed dari fungsi panggilan balik OutOfProcessExceptionEventCallback Anda ke TRUE.

Persyaratan

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