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

  • Статья

Задает текущее системное время и дату. Системное время выражается в формате UTC.

Синтаксис

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

Параметры

[in] lpSystemTime

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

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

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

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

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

Комментарии

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

Требования

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

См. также

GetSystemTime

SYSTEMTIME

SetSystemTimeAdjustment

Системное время

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