GetSystemTimeAdjustmentPrecise, fonction (sysinfoapi.h)
Détermine si le système applique des ajustements horaires programmés périodiques à son heure de la journée et obtient la valeur et la période de ces ajustements.
Syntaxe
BOOL GetSystemTimeAdjustmentPrecise(
[out] PDWORD64 lpTimeAdjustment,
[out] PDWORD64 lpTimeIncrement,
[out] PBOOL lpTimeAdjustmentDisabled
);
Paramètres
[out] lpTimeAdjustment
Retourne la fréquence de mise à jour de l’horloge ajustée.
[out] lpTimeIncrement
Retourne la fréquence de mise à jour de l’horloge.
[out] lpTimeAdjustmentDisabled
Retourne un indicateur qui spécifie si l’ajustement de l’heure est activé.
La valeur TRUE indique que l’ajustement périodique est désactivé. Dans ce cas, le système peut tenter de maintenir la synchronisation de l’horloge de la journée à l’aide de ses propres mécanismes internes. Cela peut faire en sorte que l’heure de la journée passe périodiquement à l'« heure correcte ».
La valeur FALSE indique que l’ajustement périodique et programmé de l’heure est utilisé pour sérialiser l’heure de la journée, et que le système n’interférera pas ou ne tentera pas de synchroniser l’heure de la journée seul.
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
Cette fonction est utilisée dans les algorithmes qui synchronisent l’heure de la journée avec une autre source d’heure, à l’aide d’un réglage d’horloge programmé. Pour ce faire, le système calcule la fréquence de mise à jour de l’horloge ajustée, puis cette fonction permet à l’appelant d’obtenir cette valeur.
Pour obtenir un exemple de code complet sur l’activation des privilèges au moment du système, l’ajustement de l’horloge système et l’affichage des valeurs d’horloge, consultez SetSystemTimeAdjustmentPrecise.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 (applications de bureau uniquement) |
| Serveur minimal pris en charge | Windows Server 2016 (applications de bureau uniquement) |
| Plateforme cible | Windows |
| En-tête | sysinfoapi.h |
| Bibliothèque | Mincore.lib |
| DLL | Api-ms-win-core-version-l1-2-3.dll |