На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

SetSystemTimeAdjustment



The SetSystemTimeAdjustment function tells the system to enable or disable periodic time adjustments to its time of day clock. Such time adjustments are used to synchronize the time of day with some other source of time information. When periodic time adjustments are enabled, they are applied at each clock interrupt.

BOOL SetSystemTimeAdjustment(

DWORD dwTimeAdjustment, // size, in 100-nanosecond units, of a periodic time adjustment
BOOL bTimeAdjustmentDisabled // whether periodic time adjustment is to be disabled or enabled
);


Parameters

dwTimeAdjustment

Specifies the number of 100-nanosecond units added to the time-of-day clock at each clock interrupt if periodic time adjustment is enabled.

bTimeAdjustmentDisabled

Specifies the time adjustment mode that the system is to use. Periodic system time adjustments can be disabled or enabled.
A value of TRUE specifies that periodic time adjustment is to be disabled. The system is free to adjust time of day using its own internal mechanisms. The value of dwTimeAdjustment is ignored. The system's internal adjustment mechanisms may cause the time-of-day clock to jump noticeably when adjustments are made.
A value of FALSE specifies that periodic time adjustment is to be enabled, and will be used to adjust the time-of-day clock. The system will not interfere with the time adjustment scheme, and will not attempt to synchronize time of day on its own. The system will add the value of dwTimeAdjustment to the time of day at each clock interrupt.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError. One way the function can fail is if the caller does not possess the SE_SYSTEMTIME_NAME privilege.

Remarks

The GetSystemTimeAdjustment and SetSystemTimeAdjustment functions support algorithms that synchronize the time-of-day clock, reported via GetSystemTime and GetLocalTime, with another time source using a periodic time adjustment.
The SetSystemTimeAdjustment function supports two modes of time synchronization: time-adjustment - disabled and time-adjustment - enabled.
In the first mode, bTimeAdjustmentDisabled is set to FALSE. At each clock interrupt, the system adds the value of dwTimeAdjustment to the time of day. The clock interrupt rate may be determined by calling GetSystemTimeAdjustment, and looking at the returned value of the DWORD value pointed to by lpTimeIncrement.

In the second mode, bTimeAdjustmentDisabled is set to TRUE. At each clock interrupt, the system adds the interval between clock interrupts to the time of day. No adjustment to that interval is made. The system is free to periodically refresh the time-of-day clock using other techniques. Such other techniques may cause the time-of-day clock to jump noticeably when adjustments are made.
An application must have system-time privilege (the SE_SYSTEMTIME_NAME privilege) for this function to succeed. The SE_SYSTEMTIME_NAME privilege is disabled by default. Use the AdjustTokenPrivileges function to enable the privilege before calling SetSystemTimeAdjustment, and then to disable the privilege after the SetSystemTimeAdjustment call.

See Also

AdjustTokenPrivileges, GetSystemTimeAdjustment, SetLocalTime, SetSystemTime, SystemTimeToTzSpecificLocalTime


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

SetSystemTimeAdjustment



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

BOOL SetSystemTimeAdjustment(

dwTimeAdjustment DWORD, // РАЗМЕР, в течение устройств 100- наносекунды, периодической установки времени BOOL bTimeAdjustmentDisabled // независимо периодическая установка времени должна быть выведена из строя или приспособлена
);


Параметры

dwTimeAdjustment

Определяет номер устройств 100- наносекунды добавленной к датчику времени в каждом прерывании часов если периодическая установка времени приспособлена.

bTimeAdjustmentDisabled

Определяет сборочный режим времени, что система должна использовать. Периодические системные установки времени могут быть выведены из строя или приспособлены.
Величина ИСТИНЫ определяет, что периодическая установка времени должна быть выведена из строя. Система свободна, чтобы регулировать время дня, использовавшего собственные внутренние механизмы. Величина dwTimeAdjustment проигнорирована. Системные внутренние сборочные механизмы могут заставить датчик времени, чтобы прыгать заметно когда установки сделаны.
Величина ЛЖИ определяет, что периодическая установка времени должна быть приспособлена, и быть использована, чтобы регулировать датчик времени. Система не создастся помехи с сборочной схемой времени, и не попытается синхронизировать время дня на своем собственном. Система добавит величину dwTimeAdjustment ко времени дня в каждом прерывании часов.



Обратные Величины

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

Замечания

GetSystemTimeAdjustment И алгоритмы поддержки функций SetSystemTimeAdjustment, которые синхронизируют датчик времени, сообщались через GetSystemTime и GetLocalTime, с другим источником времени, использовавшим периодическую установку времени.
Функция SetSystemTimeAdjustment поддерживает два режима синхронизации времени: время-установка - выведенное из строя и время-установка - приспособленное.
В первом режиме, bTimeAdjustmentDisabled, установлен в ЛОЖЬ. В каждом прерывании часов, система добавляет величину dwTimeAdjustment ко времени дня. Показатель прерывания часов может быть определен вызовом GetSystemTimeAdjustment, и смотря на возвращанную величину величины DWORD указанной, чтобы lpTimeIncrement.

Во втором режиме, bTimeAdjustmentDisabled, установлен в ИСТИНУ. В каждом прерывании часов, система добавляет интервал между прерываниями часов во время дня. Никакая установка в этот интервал не сделана. Система свободна, чтобы периодически освежать датчик времени, использовавший другие методы. Другие методы могут заставить датчик времени, чтобы прыгать заметно когда установки сделаны.
Приложение должно иметь системное время привилегии ( привилегия SE_SYSTEMTIME_NAME) для этой функции, чтобы добиваться успеха. Привилегия SE_SYSTEMTIME_NAME выводится из строя по умолчанию. Используйте функцию AdjustTokenPrivileges, чтобы приспосабливаться привилегию перед вызовом SetSystemTimeAdjustment, и затем, чтобы выводить из строя привилегию после вызов SetSystemTimeAdjustment.

Смотри Также

AdjustTokenPrivileges, GetSystemTimeAdjustment, SetLocalTime, SetSystemTime, SystemTimeToTzSpecificLocalTime


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz