_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.