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 |