Функция SetLocalTime устанавливает текущее местное время и дату.
BOOL SetLocalTime( const SYSTEMTIME* lpSystemTime ); |
[in] Указатель на структуру SYSTEMTIME, которая содержит в себе текущую локальную дату и время.
Член wDayOfWeek структуры SYSTEMTIME игнорируется.
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, возвращаемое значение - нуль. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Функция SetLocalTime включает право доступа SE_SYSTEMTIME_NAME перед тем, как изменить местное время. Это право доступа блокируется по умолчанию. Для получения дополнительной информации, см. статью Запуск программы со специальными правами доступа (привилегиями).
Система использует универсальное глобальное время (UTC) внутри себя. Поэтому, когда Вы вызываете функцию SetLocalTime, система использует текущую информацию часового пояса, чтобы выполнить преобразование, включая параметр летнего времени.Обратите внимание! на то, что система использует параметр летнего текущего времени, а не новое время, которое Вы установили. |
Поэтому, чтобы гарантировать правильный результат, вызовите SetLocalTime во второй раз, чтобы модернизировать первый вызов установки летнего времени.
Обзор Время (операционной системы), Функции, используемые для времени, GetLocalTime, GetSystemTime, SetSystemTimeAdjustment, SYSTEMTIME
Размещение и совместимость SetLocalTime | ||
К | Windows Vista | Да |
л | Windows XP | Да |
и | Windows 2000 Professional | Да |
е | Windows NT Workstation | Да |
н | Windows Me | Да |
т | Windows 98 | Да |
Windows 95 | Да | |
С | Windows Server 2008 | Да |
е | Windows Server 2003 | Да |
р | Windows 2000 Server | Да |
в | Windows NT Server | Да |
е | ||
р | ||
Используемая библиотека | Kernel32.lib | |
Используемая DLL | kernel32.dll | |
Заголовочный файл | ||
- объявлено в | Winbase.h | |
- включено в | Windows.h | |
Unicode | Нет | |
Замечания по платформе | Не имеется |