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
| 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 |