GetSystemTimeAdjustment, fonction (sysinfoapi.h)

Détermine si le système applique des ajustements d’heure périodiques à son horloge d’heure et obtient la valeur et la période de ces ajustements.

Syntaxe

BOOL GetSystemTimeAdjustment(
  [out] PDWORD lpTimeAdjustment,
  [out] PDWORD lpTimeIncrement,
  [out] PBOOL  lpTimeAdjustmentDisabled
);

Paramètres

[out] lpTimeAdjustment

Pointeur vers une variable que la fonction définit sur le nombre d’unités lpTimeIncrement de 100 nanosecondes ajoutées à l’horloge de l’heure de la journée pour chaque période de temps qui passe réellement comme compté par le système. Cette valeur a une signification uniquement si lpTimeAdjustmentDisabled a la valeur FALSE.

[out] lpTimeIncrement

Pointeur vers une variable que la fonction définit vers l’intervalle en unités de 100 nanosecondes auquel le système ajoute lpTimeAdjustment à l’horloge de l’heure du jour. Cette valeur a une signification uniquement si lpTimeAdjustmentDisabled a la valeur FALSE.

[out] lpTimeAdjustmentDisabled

Pointeur vers une variable que la fonction définit pour indiquer si l’ajustement de temps périodique est en vigueur.

La valeur TRUE indique que l’ajustement périodique de l’heure est désactivé et que l’horloge de l’heure du système avance au rythme normal. Dans ce mode, le système peut ajuster l’heure de la journée à l’aide de ses propres mécanismes de synchronisation d’heure internes. Ces mécanismes internes de synchronisation de l’heure peuvent entraîner une modification de l’heure de la journée pendant le cours normal de l’opération système, ce qui peut inclure des sauts dans le temps notables jugés nécessaires par le système.

La valeur FALSE indique que l’ajustement périodique de l’heure est utilisé pour ajuster l’horloge de l’heure de la journée. Pour chaque période lpTimeIncrement qui passe réellement, lpTimeAdjustment est ajouté à l’heure de la journée. Si la valeur lpTimeAdjustment est plus petite que lpTimeIncrement, l’horloge de l’heure du jour du système avance à un rythme plus lent que la normale. Si la valeur lpTimeAdjustment est supérieure à celle de lpTimeIncrement, l’horloge de l’heure de la journée avance à un rythme plus rapide que la normale. Si lpTimeAdjustment est égal à lpTimeIncrement, l’horloge de l’heure de la journée avance à sa vitesse normale. La valeur lpTimeAdjustment peut être définie en appelant SetSystemTimeAdjustment. La valeur lpTimeIncrement est corrigée par le système au démarrage et ne change pas pendant le fonctionnement du système. Dans ce mode, le système n’interfère pas avec le schéma d’ajustement de l’heure et ne tente pas de synchroniser l’heure de la journée par lui-même via d’autres techniques.

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

Les fonctions GetSystemTimeAdjustment et SetSystemTimeAdjustment peuvent être utilisées pour prendre en charge des algorithmes qui souhaitent synchroniser l’horloge de la journée, signalée par GetSystemTime et GetLocalTime, avec une autre source d’heure à l’aide d’un ajustement d’heure périodique.

La fonction GetSystemTimeAdjustment permet à un appelant de déterminer si l’ajustement du temps périodique est activé et, le cas échéant, d’obtenir la quantité de chaque ajustement et le temps entre les ajustements. La fonction SetSystemTimeAdjustment permet à un appelant d’activer ou de désactiver l’ajustement périodique de l’heure et de définir la valeur de l’incrément d’ajustement.

Configuration requise

Voir aussi

GetLocalTime

GetSystemTime

SetSystemTimeAdjustment

Temps système

Fonctions de temps