Fungsi RaiseFailFastException (errhandlingapi.h)

Menimbulkan pengecualian yang melewati semua penangan pengecualian (berbasis bingkai atau vektor). Meningkatkan pengecualian ini mengakhiri aplikasi dan memanggil Pelaporan Galat Windows, jika Pelaporan Galat Windows diaktifkan.

Sintaks

VOID RaiseFailFastException(
  [in, optional] PEXCEPTION_RECORD pExceptionRecord,
  [in, optional] PCONTEXT          pContextRecord,
  [in]           DWORD             dwFlags
);

Parameter

[in, optional] pExceptionRecord

Penunjuk ke struktur EXCEPTION_RECORD yang berisi informasi pengecualian. Anda harus menentukan anggota ExceptionAddress dan ExceptionCode .

Jika parameter ini NULL, fungsi membuat catatan pengecualian dan mengatur anggota ExceptionCode ke STATUS_FAIL_FAST_EXCEPTION. Fungsi ini juga akan mengatur anggota ExceptionAddress jika parameter dwFlags berisi bendera FAIL_FAST_GENERATE_EXCEPTION_ADDRESS.

[in, optional] pContextRecord

Penunjuk ke struktur CONTEXT yang berisi informasi konteks. Jika NULL, fungsi ini menghasilkan konteks (namun, konteksnya tidak akan sama persis dengan konteks pemanggil).

[in] dwFlags

Anda dapat menentukan nol atau bendera berikut yang mengontrol perilaku fungsi ini:

Nilai	Makna
FAIL_FAST_GENERATE_EXCEPTION_ADDRESS 0x1	Menyebabkan RaiseFailFastException mengatur ExceptionAddressEXCEPTION_RECORD ke alamat pengembalian fungsi ini (instruksi berikutnya dalam pemanggil setelah panggilan ke RaiseFailFastException). Fungsi ini akan mengatur alamat pengecualian hanya jika ExceptionAddress bukan NULL.

Mengembalikan nilai

Tidak ada

Keterangan

Biasanya, Anda memanggil fungsi ini jika aplikasi Anda dalam keadaan buruk dan Anda ingin segera mengakhiri aplikasi dan membuat Laporan Kesalahan Windows.

Jika layanan WER dinonaktifkan atau tidak dapat dimulai atau tidak ada debugger yang melekat pada proses, proses akan dihentikan.

Fungsi ini meningkatkan pengecualian kesempatan kedua. Jika penelusuran kesalahan JIT diaktifkan, debugger akan dilampirkan ke proses.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	errhandlingapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Environment.FailFast