Share via


_get_doserrno

Gets the error value returned by the operating system before it is translated into an errno value.

errno_t _get_doserrno( 
   int * pValue 
); 

Parameters

  • [out] pValue
    A pointer to an integer to be filled with the current value of the _doserrno global macro.

Return Value

If _get_doserrno succeeds, it returns zero; if it fails, it returns an error code. If pValue is NULL, the invalid parameter handler is invoked, as described in Parameter Validation. If execution is allowed to continue, this function sets errno to EINVAL and returns EINVAL.

Remarks

The _doserrno global macro is set to zero during CRT initialization, before process execution begins. It is set to the operating-system error value returned by any system-level function call that returns an operating-system error, and it is never reset to zero during execution. When you write code to check the error value returned by a function, always clear _doserrno by using _set_doserrno before the function call. Because another function call may overwrite _doserrno, check the value by using _get_doserrno immediately after the function call.

We recommend _get_errno instead of _get_doserrno for portable error codes.

Possible values of _doserrno are defined in <errno.h>.

Requirements

Routine

Required header

Optional header

_get_doserrno

<stdlib.h>, <cstdlib> (C++)

<errno.h>, <cerrno> (C++)

_get_doserrno is a Microsoft extension. For more compatibility information, see Compatibility.

See Also

Reference

_set_doserrno

errno, _doserrno, _sys_errlist, and _sys_nerr