Функция SetSystemTime устанавливает время текущей операционной системы и дату. Системное время выражено в Универсальном глобальном времени (UTC).
BOOL SetSystemTime( const SYSTEMTIME* 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 | Нет | |
Замечания по платформе | Не имеется |