Fonction SetLastError (errhandlingapi.h)
Définit le code de dernière erreur pour le thread appelant.
Syntaxe
void SetLastError(
[in] DWORD dwErrCode
);
Paramètres
[in] dwErrCode
Code de la dernière erreur pour le thread.
Valeur de retour
None
Remarques
Le code de la dernière erreur est conservé dans le stockage local des threads afin que plusieurs threads ne remplacent pas les valeurs des uns et des autres.
La plupart des fonctions appellent SetLastError ou SetLastErrorEx uniquement en cas d’échec. Toutefois, certaines fonctions système appellent SetLastError ou SetLastErrorEx dans des conditions de réussite ; ces cas sont notés dans la documentation de chaque fonction.
Les applications peuvent éventuellement récupérer la valeur définie par cette fonction à l’aide de la fonction GetLastError immédiatement après l’échec d’une fonction.
Les codes d’erreur sont des valeurs 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 ; ce bit n’est défini pour aucun code d’erreur. 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’est pas en conflit avec les codes d’erreur définis par le système.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | errhandlingapi.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |