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

Статья
08/26/2023

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

Синтаксис

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