Partager via


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