_get_doserrno

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

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.

Si _get_doserrno réussit, retourne zéro ; en cas d'échec, retourne un code d'erreur. Si pValue est 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.

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. Lorsque vous écrivez du code pour vérifier la valeur d’erreur retournée par une fonction, effacez toujours _doserrno à l’aide de _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 vous recommandons de _get_errno au lieu de _get_doserrno pour les codes d’erreur portable.

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

RoutineEn-tête requisEn-tête facultatif
_get_doserrno<stdlib.h>, <>> (C++)</stdlib.h><errno.h>, <>> (C++)</errno.h>

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

_set_doserrno
errno, _doserrno, _sys_errlist et _sys_nerr

Afficher: