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


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

Задает текущее местное время и дату.

Синтаксис

BOOL SetLocalTime(
  [in] const SYSTEMTIME *lpSystemTime
);

Параметры

[in] lpSystemTime

Указатель на структуру SYSTEMTIME , содержащую новые локальные дату и время.

Элемент wDayOfWeek структуры SYSTEMTIME игнорируется.

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

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

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

Комментарии

Вызывающий процесс должен иметь привилегию SE_SYSTEMTIME_NAME. Эта привилегия отключена по умолчанию. Функция SetLocalTime включает привилегию SE_SYSTEMTIME_NAME перед изменением местного времени и отключает привилегию перед возвратом. Дополнительные сведения см. в разделе Выполнение с особыми привилегиями.

Система использует время UTC для внутренних целей. Таким образом, при вызове SetLocalTime система использует текущие сведения о часовом поясе для выполнения преобразования, включая летнее время. Обратите внимание, что система использует летнее время текущего времени, а не нового времени. Поэтому, чтобы обеспечить правильный результат, вызовите SetLocalTime во второй раз, теперь, когда первый вызов обновил параметр летнего времени.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header sysinfoapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

GetLocalTime

GetSystemTime

Местное время

SYSTEMTIME

SetSystemTimeAdjustment

Функции времени