Поделиться через


Функция GetSystemTimeAdjustmentPrecise (sysinfoapi.h)

Определяет, применяет ли система периодические, программные корректировки времени к своим часам времени суток, и получает значение и период любых таких корректировок.

Синтаксис

BOOL GetSystemTimeAdjustmentPrecise(
  [out] PDWORD64 lpTimeAdjustment,
  [out] PDWORD64 lpTimeIncrement,
  [out] PBOOL    lpTimeAdjustmentDisabled
);

Параметры

[out] lpTimeAdjustment

Возвращает скорректированную частоту обновления часов.

[out] lpTimeIncrement

Возвращает частоту обновления часов.

[out] lpTimeAdjustmentDisabled

Возвращает индикатор, указывающий, включена ли корректировка времени.

Значение TRUE указывает, что периодическая корректировка отключена. В этом случае система может попытаться синхронизировать время суток, используя собственные внутренние механизмы. Это может привести к периодическому переходу времени дня к "правильному времени".

Значение FALSE указывает, что для сериализации времени используется периодическая запрограммированная корректировка времени, и система не будет мешать или пытаться синхронизировать время дня самостоятельно.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Эта функция используется в алгоритмах, которые синхронизируют время суток с другим источником времени, используя запрограммированную настройку часов. Для этого система вычисляет скорректированную частоту обновления часов, а затем эта функция позволяет вызывающей объекту получить это значение.

Примечание  

Полный пример кода о том, как включить права системного времени, настроить системные часы и отобразить значения часов, см. в разделе SetSystemTimeAdjustmentPrecise.

 

Требования

Требование Значение
Минимальная версия клиента Windows 10 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Целевая платформа Windows
Header sysinfoapi.h
Библиотека Mincore.lib
DLL Api-ms-win-core-version-l1-2-3.dll

См. также раздел

SetSystemTimeAdjustmentPrecise