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