Функция SetLocalTime

Функция SetLocalTime устанавливает текущее местное время и дату.

Синтаксис

BOOL SetLocalTime(
  const SYSTEMTIME* lpSystemTime
);

Параметры

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 Нет
Замечания по платформе Не имеется

 

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

Hosted by uCoz