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 |