Функция SetSystemTime

Функция SetSystemTime устанавливает время текущей операционной системы и дату. Системное время выражено в Универсальном глобальном времени (UTC).

Синтаксис

BOOL SetSystemTime(
  const SYSTEMTIME* lpSystemTime
);

Параметры

lpSystemTime

[in] Указатель на структуру SYSTEMTIME, которая содержит в себе дату и время текущей операционной системы.

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

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

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

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

Замечания

Функция SetSystemTime позволяет включить право доступа SE_SYSTEMTIME_NAME, перед тем, как изменится системное время. Это право доступа (привилегия) блокируется по умолчанию. Для получения дополнительной информации, см. статью Запуск программы со специальными правами доступа (привилегиями).

Демонстрационный код

Пример смотри в статье Установка системного времени.

Смотри также

Обзор Время (операционной системы), Функции, используемые для времени, GetSystemTime, SetSystemTimeAdjustment, SYSTEMTIME

Размещение и совместимость SetSystemTime
К 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 Нет
Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz