Bagikan melalui


Fungsi SetLastError (errhandlingapi.h)

Mengatur kode kesalahan terakhir untuk utas panggilan.

Sintaks

void SetLastError(
  [in] DWORD dwErrCode
);

Parameter

[in] dwErrCode

Kode kesalahan terakhir untuk utas.

Nilai kembali

Tidak ada

Keterangan

Kode kesalahan terakhir disimpan dalam 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 Anda dan untuk memastikan bahwa kode kesalahan Anda tidak bertentangan dengan kode kesalahan yang ditentukan sistem.

Persyaratan

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

Lihat juga

Fungsi Penanganan Kesalahan

GetLastError

Kode Kesalahan Terakhir

SetLastErrorEx

Api Vertdll tersedia di enklave VBS