Fonction SetSystemTime (sysinfoapi.h)

Définit l’heure et la date système actuelles. L’heure système est exprimée en temps universel coordonné (UTC).

Syntaxe

BOOL SetSystemTime(
  [in] const SYSTEMTIME *lpSystemTime
);

Paramètres

[in] lpSystemTime

Pointeur vers une structure SYSTEMTIME qui contient la date et l’heure du nouveau système.

Le membre wDayOfWeek de la structure SYSTEMTIME est ignoré.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Le processus appelant doit avoir le privilège SE_SYSTEMTIME_NAME. Ce privilège est désactivé par défaut. La fonction SetSystemTime active le privilège SE_SYSTEMTIME_NAME avant de modifier l’heure système et désactive le privilège avant le retour. Pour plus d’informations, consultez Exécution avec des privilèges spéciaux.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	sysinfoapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

GetSystemTime

SYSTEMTIME

SetSystemTimeAdjustment

Temps système

Fonctions de temps