Fungsi UnhandledExceptionFilter (errhandlingapi.h)

Artikel
08/23/2023

Fungsi yang ditentukan aplikasi yang meneruskan pengecualian yang tidak tertangani ke debugger, jika proses sedang di-debug. Jika tidak, secara opsional menampilkan kotak pesan Kesalahan Aplikasi dan menyebabkan handler pengecualian dijalankan. Fungsi ini hanya dapat dipanggil dari dalam ekspresi filter penangan pengecualian.

Sintaks

LONG UnhandledExceptionFilter(
  [in] _EXCEPTION_POINTERS *ExceptionInfo
);

Parameter

[in] ExceptionInfo

Penunjuk ke struktur EXCEPTION_POINTERS yang menentukan deskripsi pengecualian dan konteks prosesor pada saat pengecualian. Pointer ini adalah nilai pengembalian panggilan ke fungsi GetExceptionInformation .

Menampilkan nilai

Fungsi mengembalikan salah satu nilai berikut.

Mengembalikan kode/nilai	Deskripsi
EXCEPTION_CONTINUE_SEARCH 0x0	Proses sedang di-debug, sehingga pengecualian harus diteruskan (sebagai kesempatan kedua) ke debugger aplikasi.
EXCEPTION_EXECUTE_HANDLER 0x1	Jika bendera SEM_NOGPFAULTERRORBOX ditentukan dalam panggilan sebelumnya ke SetErrorMode, tidak ada kotak pesan Kesalahan Aplikasi yang ditampilkan. Fungsi mengembalikan kontrol ke handler pengecualian, yang bebas untuk mengambil tindakan yang sesuai.

Keterangan

Jika proses tidak di-debug, fungsi menampilkan kotak pesan Kesalahan Aplikasi , tergantung pada mode kesalahan saat ini. Perilaku default adalah menampilkan kotak dialog, tetapi ini dapat dinonaktifkan dengan menentukan SEM_NOGPFAULTERRORBOX dalam panggilan ke fungsi SetErrorMode .

Sistem ini menggunakan UnhandledExceptionFilter secara internal untuk menangani pengecualian yang terjadi selama proses dan pembuatan utas.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	errhandlingapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll