_get_doserrno

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

Syntax

errno_t _get_doserrno(
   int * pValue
);

Parameters

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's set to the operating-system error value returned by any system-level function call that returns an operating-system error, and it's 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>.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

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

See also

_set_doserrno
errno, _doserrno, _sys_errlist, and _sys_nerr