GetSystemTimeAdjustmentPrecise-Funktion (sysinfoapi.h)
Bestimmt, ob das System periodische, programmierte Zeitanpassungen auf seine Tageszeituhr anwendet, und erhält den Wert und den Zeitraum solcher Anpassungen.
Syntax
BOOL GetSystemTimeAdjustmentPrecise(
[out] PDWORD64 lpTimeAdjustment,
[out] PDWORD64 lpTimeIncrement,
[out] PBOOL lpTimeAdjustmentDisabled
);
Parameter
[out] lpTimeAdjustment
Gibt die angepasste Taktaktualisierungshäufigkeit zurück.
[out] lpTimeIncrement
Gibt die Taktaktualisierungshäufigkeit zurück.
[out] lpTimeAdjustmentDisabled
Gibt einen Indikator zurück, der angibt, ob die Zeitanpassung aktiviert ist.
Der Wert TRUE gibt an, dass die regelmäßige Anpassung deaktiviert ist. In diesem Fall versucht das System möglicherweise, die Tageszeituhr mithilfe eigener interner Mechanismen synchron zu halten. Dies kann dazu führen, dass die Tageszeit regelmäßig zur "richtigen Zeit" springt.
Der Wert FALSE gibt an, dass die periodische, programmierte Zeitanpassung verwendet wird, um die Tageszeit zu serialisieren, und das System nicht beeinträchtigt oder versucht, die Tageszeit selbst zu synchronisieren.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Diese Funktion wird in Algorithmen verwendet, die die Tageszeit mithilfe einer programmierten Zeitanpassung mit einer anderen Zeitquelle synchronisieren. Dazu berechnet das System die angepasste Taktaktualisierungshäufigkeit, und dann ermöglicht diese Funktion dem Aufrufer, diesen Wert abzurufen.
Ein vollständiges Codebeispiel zum Aktivieren von Systemzeitberechtigungen, Anpassen der Systemuhr und Anzeigen von Uhrwerten finden Sie unter SetSystemTimeAdjustmentPrecise.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | sysinfoapi.h |
| Bibliothek | Mincore.lib |
| DLL | Api-ms-win-core-version-l1-2-3.dll |