_get_doserrno

Obtient la valeur d’erreur retournée par le système d’exploitation avant qu’elle ne soit convertie en errno valeur.

Syntaxe

errno_t _get_doserrno(
   int * pValue
);

Paramètres

pValue
Pointeur vers un entier à remplir avec la valeur actuelle de la macro globale _doserrno.

Valeur retournée

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 errno à EINVAL 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 est définie sur la valeur d’erreur du système d’exploitation retournée par n’importe quel appel de fonction au niveau du système qui retourne une erreur de système d’exploitation et n’est jamais réinitialisée à zéro pendant l’exécution. Lorsque vous écrivez du code pour vérifier la valeur d’erreur retournée par une fonction, effacez _doserrno toujours l’utilisation _set_doserrno avant l’appel de la 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 vous recommandons _get_errno plutôt que les _get_doserrno codes d’erreur portables.

Les valeurs possibles sont _doserrno définies dans <errno.h>.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

_get_doserrno est une extension Microsoft. Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

_set_doserrno
errno, _doserrno, _sys_errlist et _sys_nerr