SetLastError

Syntaxe

Paramètres

Description

Cette fonction permet de fixer le code de la dernière erreur d'un appel de processus léger.

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 votre 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 d'une fonction 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. L'utilisation de la fonction GetLastError est facultative. Ainsi, une application peut l'appeler pour connaître la raison spécifique de l'échec d'une fonction.
• 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 - SetLastErrorEx
Langage de programmation - C pour Windows - API de Windows - TlsGetValue