Compartilhar via


_get_doserrno

Obtém o valor de erro retornado pelo sistema operacional antes de ser convertido em um errno valor.

Sintaxe

errno_t _get_doserrno(
   int * pValue
);

Parâmetros

pValue
Um ponteiro para um inteiro que deve ser preenchido com o valor atual da macro global _doserrno.

Valor retornado

Se _get_doserrno tiver êxito, o valor retornado é zero. Em caso de falha, o valor retornado é um código de erro. Se pValue for NULL, o manipulador de parâmetro inválido será chamado, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essa função definirá errno para EINVAL e retornará EINVAL.

Comentários

A macro global _doserrno é definida como zero durante a inicialização do CRT (tempo de execução C), antes do início do processo de execução. Ele é definido como o valor de erro do sistema operacional retornado por qualquer chamada de função no nível do sistema que retorna um erro do sistema operacional e nunca é redefinido como zero durante a execução. Quando você escreve código para verificar o valor de erro retornado por uma função, sempre limpe _doserrno usando _set_doserrno antes da chamada de função. Como outra chamada de função pode substituir _doserrno, verifique o valor usando _get_doserrno logo após a chamada de função.

Recomendamos _get_errno em vez de códigos de _get_doserrno erro portáteis.

Os valores possíveis de _doserrno são definidos em <errno.h>.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Rotina Cabeçalho necessário Cabeçalho opcional
_get_doserrno <stdlib.h>, <cstdlib> (C++) <errno.h>, <cerrno> (C++)

_get_doserrno é uma extensão da Microsoft. Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

_set_doserrno
errno, _doserrno, _sys_errlist e _sys_nerr