SetLocalTime, fonction (sysinfoapi.h)

Définit l’heure et la date locales actuelles.

Syntaxe

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

Paramètres

[in] lpSystemTime

Pointeur vers une structure SYSTEMTIME qui contient les nouvelles date et heure locales.

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 SetLocalTime active le privilège SE_SYSTEMTIME_NAME avant de modifier l’heure locale et désactive le privilège avant de revenir. Pour plus d’informations, consultez Exécution avec des privilèges spéciaux.

Le système utilise utc en interne. Par conséquent, lorsque vous appelez SetLocalTime, le système utilise les informations de fuseau horaire actuel pour effectuer la conversion, y compris le paramètre d’heure d’été. Notez que le système utilise le paramètre d’heure d’été de l’heure actuelle, et non la nouvelle heure que vous définissez. Par conséquent, pour garantir le résultat correct, appelez SetLocalTime une deuxième fois, maintenant que le premier appel a mis à jour le paramètre d’heure d’été.

Configuration requise

Voir aussi

GetLocalTime

GetSystemTime

Heure locale

SYSTEMTIME

SetSystemTimeAdjustment

Fonctions de temps