_get_doserrno
Obtient la valeur d'erreur retournée par le système d'exploitation avant qu'elle ne soit traduite en valeur errno.
errno_t _get_doserrno( int * pValue );
Paramètres
- [out] pValue
Pointeur vers un entier à remplir avec la valeur actuelle de la macro globale _doserrno.
Valeur de retour
Si _get_doserrno réussit, retourne zéro ; en cas d'échec, retourne un code d'erreur. Si pValue a la valeur NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction affecte la valeur EINVAL à errno et retourne EINVAL.
Notes
La macro globale _doserrno prend la valeur zéro pendant l'initialisation CRT, avant le début de l'exécution du processus. Elle prend la valeur d'erreur du système d'exploitation retournée par tout appel de fonction au niveau système qui retourne une erreur de système d'exploitation, et elle n'est jamais réinitialisée à zéro pendant l'exécution. Quand vous écrivez du code pour vérifier la valeur d'erreur retournée par une fonction, effacez toujours _doserrno en utilisant _set_doserrno avant l'appel de fonction. Comme un autre appel de fonction peut remplacer _doserrno, vérifiez la valeur en utilisant _get_doserrno immédiatement après l'appel de fonction.
Nous conseillons _get_errno au lieu de _get_doserrno pour les codes d'erreurs portables.
Les valeurs possibles de _doserrno sont définies dans <errno.h>.
Configuration requise
Routine |
En-tête requis |
En-tête facultatif |
---|---|---|
_get_doserrno |
<stdlib.h>, <cstdlib> (C++) |
<errno.h>, <cerrno> (C++) |
_get_doserrno est une extension Microsoft. Pour plus d'informations sur la compatibilité, voir Compatibilité.