SetLastErrorEx |
user32.dll | Fixe la dernière erreur étendue |
---|---|---|
Windows 9X, NT 3.1+, 2000, XP, 2003 |
Syntaxe
VOID SetLastErrorEx(DWORD fdwError, DWORD fdwType); |
Paramètres
Nom | Description | |
---|---|---|
fdwError | Ce paramètre permet d'indiquer le code de la dernière erreur pour le processus léger. | |
fdwType | Ce paramètre permet d'indiquer le type d'erreur. Si ce processus est contrôlé par un processus de débogage, le débogueur peut prendre des mesures en fonction du type d'erreur. Ce paramètre peut avoir l'une des valeurs suivantes : | |
Valeur | Description | |
SLE_ERROR | Cette valeur permet d'indiquer des données non valides ont été transmises à la fonction et qu'un échec complet s'est produit. | |
SLE_MINORERROR | Cette valeur permet d'indiquer des données non valides ont été transmises à la fonction, mais celle-ci a été récupérée. | |
SLE_WARNING | Cette valeur permet d'indiquer des données potentiellement non valides ont été transmises à la fonction, mais celle-ci a été récupérée. | |
0 | Cette valeur permet d'indiquer que le code de la dernière erreur est défini sans rien signaler au débogueur. Spécifier cette valeur revient à utiliser la fonction SetLastError. |
Description
Cette fonction permet de fixer le code de la dernière erreur avec un type d'erreur.
Remarques
- Les codes d'erreur sont des valeurs de 32 bits (le bit 31 est le bit le plus significatif). Le bit 29 est réservé aux codes d'erreur définis par l'application; aucun code d'erreur de l'API Win32 n'a ce bit défini. Si vous définissez un code d'erreur pour votre application, définissez ce bit pour indiquer que le code d'erreur a été défini par l'application et pour vous assurer que votre code d'erreur n'entre pas en conflit avec les codes d'erreur définis par le système.
- Cette fonction est principalement destinée aux bibliothèques de liens dynamiques (DLL). L'appel de cette fonction après une erreur permet à la DLL d'émuler le comportement de l'API Win32.
- La plupart des fonctions Win32 appellent SetLastError quand elles échouent. Une défaillance de fonction est généralement indiquée par un code d'erreur de valeur de retour tel que FALSE, NULL, 0xFFFFFFFF. Certaines fonctions appellent SetLastError dans des conditions de réussite; ces cas sont notés dans la page de référence de chaque fonction.
- Les applications peuvent récupérer la valeur enregistrée par cette fonction à l'aide de la fonction GetLastError.
- Le dernier code d'erreur est conservé dans l'entreposage local du processus léger afin que plusieurs processus léger ne remplacent pas les valeurs de l'autre.
Voir également
Langage de programmation - C pour Windows - API de Windows - GetLastError
Langage de programmation - C pour Windows - API de Windows - SetLastError
Dernière mise à jour : Dimanche, le 6 décembre 2015