`_RTC_SetErrorFuncW`

Artikel
10/12/2023

Menunjuk fungsi sebagai handler untuk pelaporan pemeriksaan kesalahan run-time (RTC).

Sintaks

_RTC_error_fnW _RTC_SetErrorFuncW(
   _RTC_error_fnW function
);

Parameter

function
Alamat fungsi yang akan menangani pemeriksaan kesalahan run-time.

Nilai hasil

Fungsi kesalahan yang ditentukan sebelumnya; atau NULL jika tidak ada fungsi yang ditentukan sebelumnya.

Keterangan

Dalam kode baru, gunakan hanya _RTC_SetErrorFuncW. _RTC_SetErrorFunc hanya disertakan dalam pustaka untuk kompatibilitas mundur.

Panggilan _RTC_SetErrorFuncW balik hanya berlaku untuk komponen tempat panggilan ditautkan, tetapi tidak secara global.

Pastikan bahwa alamat yang Anda teruskan _RTC_SetErrorFuncW adalah alamat fungsi penanganan kesalahan yang valid.

Jika kesalahan telah diberi jenis -1 dengan menggunakan _RTC_SetErrorType, fungsi penanganan kesalahan tidak dipanggil.

Sebelum dapat memanggil fungsi ini, Anda harus terlebih dahulu memanggil salah satu fungsi inisialisasi pemeriksaan kesalahan run-time. Untuk informasi selengkapnya, lihat Menggunakan pemeriksaan runtime tanpa pustaka runtime C.

_RTC_error_fnW didefinisikan sebagai berikut:

typedef int (__cdecl * _RTC_error_fnW)(
    int errorType,
    const wchar_t * filename,
    int linenumber,
    const wchar_t * moduleName,
    const wchar_t * format,
    ... );

di mana:

errorType
Jenis kesalahan yang ditentukan oleh _RTC_SetErrorType.

filename
File sumber tempat kegagalan terjadi, atau null jika tidak ada informasi debug yang tersedia.

linenumber
Baris tempat filename kegagalan terjadi, atau 0 jika tidak ada informasi debug yang tersedia.

moduleName
DLL atau nama yang dapat dieksekusi tempat kegagalan terjadi.

format
string gaya printf untuk menampilkan pesan kesalahan, menggunakan parameter yang tersisa. Argumen pertama dari VA_ARGLIST adalah nomor Kesalahan RTC yang terjadi.

Untuk contoh yang menunjukkan cara menggunakan _RTC_error_fnW, lihat Kustomisasi pemeriksaan runtime asli.

Persyaratan

Rutin	Header yang diperlukan
`_RTC_SetErrorFuncW`	<rtcapi.h>

Untuk informasi selengkapnya, lihat Kompatibilitas.

Pustaka

Semua versi pustaka run-time C.