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

Voir aussi

Fonctions de gestion des erreurs

Obtenir la dernière erreur

Dernier code d’erreur

SetLastErrorEx

API Vertdll disponibles dans les enclaves VBS