Fungsi GetLastError (errhandlingapi.h)

Artikel
02/02/2024

Mengambil nilai kode kesalahan terakhir utas panggilan. Kode kesalahan terakhir dipertahankan berdasarkan per utas. Beberapa utas tidak menimpa kode kesalahan terakhir satu sama lain.

Visual Basic: Aplikasi harus memanggil err. LastDllError alih-alih GetLastError.

Sintaks

_Post_equals_last_error_ DWORD GetLastError();

Mengembalikan nilai

Nilai yang dikembalikan adalah kode kesalahan terakhir utas panggilan.

Bagian Nilai Hasil dari dokumentasi untuk setiap fungsi yang mengatur kode kesalahan terakhir mencatat kondisi di mana fungsi menetapkan kode kesalahan terakhir. Sebagian besar fungsi yang mengatur kode kesalahan terakhir utas mengaturnya saat gagal. Namun, beberapa fungsi juga mengatur kode kesalahan terakhir ketika berhasil. Jika fungsi tidak didokumenkan untuk mengatur kode kesalahan terakhir, nilai yang dikembalikan oleh fungsi ini hanyalah kode kesalahan terakhir terbaru yang telah ditetapkan; beberapa fungsi mengatur kode kesalahan terakhir ke 0 pada keberhasilan dan yang lain tidak.

Keterangan

Fungsi yang dijalankan oleh utas panggilan mengatur nilai ini dengan memanggil fungsi SetLastError . Anda harus segera memanggil fungsi GetLastError ketika nilai pengembalian fungsi menunjukkan bahwa panggilan seperti itu akan mengembalikan data yang berguna. Itu karena beberapa fungsi memanggil SetLastError dengan nol ketika berhasil, menghapus kode kesalahan yang ditetapkan oleh fungsi yang terakhir gagal.

Untuk mendapatkan string kesalahan untuk kode kesalahan sistem, gunakan fungsi FormatMessage . Untuk daftar lengkap kode kesalahan yang disediakan oleh sistem operasi, lihat Kode Kesalahan Sistem.

Kode kesalahan yang dikembalikan oleh fungsi bukan bagian dari spesifikasi Windows API dan dapat bervariasi menurut sistem operasi atau driver perangkat. Untuk alasan ini, kami tidak dapat memberikan daftar lengkap kode kesalahan yang dapat dikembalikan oleh setiap fungsi. Ada juga banyak fungsi yang dokumentasinya tidak menyertakan bahkan daftar parsial kode kesalahan yang dapat dikembalikan.

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 ke satu. Itu menunjukkan bahwa kode kesalahan telah ditentukan oleh aplikasi, dan memastikan bahwa kode kesalahan Anda tidak bertentang dengan kode kesalahan yang ditentukan oleh sistem.

Untuk mengonversi kesalahan sistem menjadi nilai HRESULT , gunakan makro HRESULT_FROM_WIN32 .

Contoh

Misalnya, lihat Mengambil Kode Last-Error.

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