`_get_doserrno`

Artikel
10/12/2023

Mendapatkan nilai kesalahan yang dikembalikan oleh sistem operasi sebelum diterjemahkan ke dalam errno nilai.

Sintaks

errno_t _get_doserrno(
   int * pValue
);

Parameter

pValue
Penunjuk ke bilangan bulat yang akan diisi dengan nilai _doserrno makro global saat ini.

Nilai hasil

Jika _get_doserrno berhasil, ia mengembalikan nol; jika gagal, kode kesalahan akan dikembalikan. Jika pValue adalah NULL, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, fungsi ini diatur errno ke EINVAL dan mengembalikan EINVAL.

Keterangan

_doserrno Makro global diatur ke nol selama inisialisasi CRT, sebelum eksekusi proses dimulai. Ini diatur ke nilai kesalahan sistem operasi yang dikembalikan oleh panggilan fungsi tingkat sistem apa pun yang mengembalikan kesalahan sistem operasi, dan tidak pernah diatur ulang ke nol selama eksekusi. Saat Anda menulis kode untuk memeriksa nilai kesalahan yang dikembalikan oleh fungsi, selalu hapus _doserrno dengan menggunakan _set_doserrno sebelum panggilan fungsi. Karena panggilan fungsi lain dapat menimpa _doserrno, periksa nilai dengan menggunakan _get_doserrno segera setelah panggilan fungsi.

Kami merekomendasikan _get_errno alih-alih _get_doserrno untuk kode kesalahan portabel.

Kemungkinan nilai _doserrno didefinisikan dalam <errno.h>.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Persyaratan

Rutin	Header yang diperlukan	Header opsional
`_get_doserrno`	<stdlib.h>, <cstdlib> (C++)	<errno.h>, <cerrno> (C++)

_get_doserrno adalah ekstensi Microsoft. Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Bagikan melalui