Fungsi SetLastErrorEx (winuser.h)

Artikel
08/28/2023

Mengatur kode kesalahan terakhir.

Saat ini, fungsi ini identik dengan fungsi SetLastError . Parameter kedua diabaikan.

Sintaks

void SetLastErrorEx(
  [in] DWORD dwErrCode,
  [in] DWORD dwType
);

Parameter

[in] dwErrCode

Kode kesalahan terakhir untuk utas.

[in] dwType

Parameter diabaikan

Menampilkan nilai

Tidak ada

Keterangan

Kode kesalahan terakhir disimpan di penyimpanan lokal utas sehingga beberapa utas tidak menimpa nilai satu sama lain.

Sebagian besar fungsi memanggil SetLastError atau SetLastErrorEx hanya ketika gagal. Namun, beberapa fungsi sistem memanggil SetLastError atau SetLastErrorEx dalam kondisi keberhasilan; kasus-kasus tersebut dicatat dalam dokumentasi setiap fungsi.

Aplikasi dapat secara opsional mengambil nilai yang ditetapkan oleh fungsi ini dengan menggunakan fungsi GetLastError segera setelah fungsi gagal.

Kode kesalahan adalah nilai 32-bit (bit 31 adalah bit yang paling signifikan). Bit 29 disediakan untuk kode kesalahan yang ditentukan aplikasi; tidak ada kode kesalahan sistem yang memiliki set bit ini. Jika Anda mendefinisikan kode kesalahan untuk aplikasi Anda, atur bit ini untuk menunjukkan bahwa kode kesalahan telah ditentukan oleh aplikasi dan untuk memastikan bahwa kode kesalahan Anda tidak bertentangan dengan kode kesalahan yang ditentukan sistem.

Persyaratan


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

Lihat juga

Fungsi Penanganan Kesalahan

GetLastError

Kode Kesalahan Terakhir

Share via