SetSystemTime

小甲鱼

注：本文档由 Diu 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

SetSystemTime 函数用于设置当前系统时间和日期。该系统时间以世界标准时间格式（UTC）表示。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL WINAPI SetSystemTime(
  _In_ const SYSTEMTIME *lpSystemTime
);

参数解析：

参数	含义
lpSystemTime	1. 一个指向 SYSTEMTIME 结构的指针，该结构包含新的系统日期和时间 2. SYSTEMTIME 结构的 wDayOfWeek 成员将被忽略。

返回值：

1. 如果函数调用成功，则返回值为非 0；

2. 如果函数调用失败，则返回值为 0；

获取有关错误的更多信息，请调用 GetLastError 函数。


备注：

调用进程必须有 SE_SYSTEMTIME_NAME 权限。该权限默认禁用。SetSystemTime 函数在改变系统时间之前打开 SE_SYSTEMTIME_NAME 权限，并在返回之前禁用该权限。更多信息，请参见 Running with Special Privileges。


需求：

Minimum supported client	Windows XP 专业版 [桌面应用程序 | Windows 商店应用程序]
Minimum supported server	Windows 2003 服务器版 [桌面应用程序 | Windows 商店应用程序]
Header	FileAPI.h (包含于 Windows.h); Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 和 Windows XP 系统上为 WinBase.h (包含于 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。