get-errno.md

description	title	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: _get_errno	_get_errno	4/2/2020	_get_errno _o__get_errno	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-runtime-l1-1-0.dll	DLLExport	apiref	_get_errno	get_errno function errno global variable _get_errno function	b3fd5ebc-f41b-4314-a2f4-2f2d79d6e740

_get_errno

Gets the current value of the errno global variable.

Syntax

errno_t _get_errno(
   int * pValue
);

Parameters

pValue
A pointer to an integer to be filled with the current value of the errno variable.

Return value

Returns zero if successful; an error code on failure. 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

Possible values of errno are defined in Errno.h. Also, see errno constants.

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

Example

// crt_get_errno.c
#include <errno.h>
#include <fcntl.h>
#include <io.h>
#include <stdio.h>
#include <sys/stat.h>

int main()
{
   errno_t err;
   int pfh;
   _sopen_s(&pfh, "nonexistent.file", _O_WRONLY, _SH_DENYNO, _S_IWRITE);
   _get_errno(&err);
   printf("errno = %d\n", err);
   printf("fyi, ENOENT = %d\n", ENOENT);
}

errno = 2
fyi, ENOENT = 2

Requirements

Routine	Required header	Optional header
_get_errno	<stdlib.h>	<errno.h>

For more compatibility information, see Compatibility.

See also

_set_errno
errno, _doserrno, _sys_errlist, and _sys_nerr