_get_doserrno
Obtém o valor do erro retornado pelo sistema operacional antes de ele ser convertido para um valor errno.
errno_t _get_doserrno( int * pValue );
Parâmetros
- [out] pValue
Um ponteiro para um inteiro que deve ser preenchido com o valor atual da macro global _doserrno.
Valor de retorno
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âmetros inválido será invocado, como descrito em Validação do 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. Ela é definida para o valor de erro do sistema operacional retornado por qualquer chamada de função de nível do sistema que retorne um erro de sistema operacional. Ela nunca é redefinida para zero durante a execução. Ao gravar o 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 que você use _get_errno em vez de _get_doserrno para códigos de erro portáteis.
Os possíveis valores de _doserrno são definidos em <errno.h>.
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 mais informações de compatibilidade, consulte Compatibilidade.