Функция GetSystemTimeAdjustment

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

Обратите внимание! на то, что период таких корректировок эквивалентен периоду времени между прерываниями часов.

Синтаксис

Параметры

[out] Указатель на значение, в которое функция устанавливает число 100 наносекундных блоков, добавленных к часам времени дня при каждой периодической корректировке времени.

[out] Указатель на значение, в которое функция устанавливает интервалы между периодическими корректировками времени 100 наносекундными блоками. Этот интервал - период времени между прерываниями часов системы.

[out] Указатель на значение, в которое функция устанавливает индикатор того, в действительности ли действует периодическая корректировка времени.

Значение TRUE указывает, что периодическая корректировка времени заблокирована. При каждом прерывании часов система просто добавляет интервал между прерываниями часов в часы времени дня. Однако система является свободной, чтобы настраивать ее часы времени дня, используя другие методы. Эти другие методы могут стать причиной того, что часы времени дня заметно перепрыгивают, когда делаются корректировки.

Значение FALSE указывает на то, что периодическая корректировка времени используется, чтобы настроить часы времени дня. При каждом прерывании часов система добавляет приращение времени, определенное параметром dwTimeIncrement функции SetSystemTimeAdjustment для часов времени дня. Система не будет сталкиваться со схемой корректировки времени и не будет пытаться синхронизировать время дня самостоятельно посредством других методов.

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

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

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

Замечания

Функции GetSystemTimeAdjustment и SetSystemTimeAdjustment поддерживают алгоритмы, которым хотят синхронизировать часы времени дня, сообщая о них функциям GetSystemTime и GetLocalTime, другим источником времени, использующим периодическую корректировку времени, применяемую при каждом прерывании часов.

Когда периодическая корректировка времени в действии, система добавляет значение регулировки к часам времени дня в периодическом интервале при каждом прерывании часов. Функция GetSystemTimeAdjustment позволяет вызывающей программе определять, включена ли периодическая корректировка времени, и если это так, то получает объем каждой корректировки и время между корректировками. Функция SetSystemTimeAdjustment позволяет вызывающей программе разрешить или запретить периодическую корректировку времени и устанавливать значение приращения регулировки.

Смотри также

Обзор Время (операционной системы), Функции, используемые для времени, SetSystemTimeAdjustment, GetSystemTime, GetLocalTime