SetLocalTime

小甲鱼

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

原文链接 -> 传送门

函数功能：

SetLocalTime 函数用于设置当前的本地时间与日期。


API 函数原型：

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

1. BOOL WINAPI SetLocalTime(
   
2.   _In_ const SYSTEMTIME *lpSystemTime
   
3. );

复制代码

参数解析：

参数	含义
lpSystemTime	1. 指向将获取当前本地日期和时间的 SYSTEMTIME 结构的指针 2. SYSTEMTIME 结构的 wDayOfWeek 成员会被忽略

返回值：

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

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

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


备注：

1. 调用进程必须具有 SE_SYSTEMTIME_NAME 特权。该特权在默认情况下是被禁用的。SetLocalTime 函数在改变本地时间之前会开启 SE_SYSTEMTIME_NAME 特权，并且在返回之前关闭该特权。更多信息，参见 Running with Special Privileges。

2. 系统内部使用 UTC 时间。因此，当你调用 SetLocalTime 函数时，系统使用当前时区信息来执行转换，包括夏令时设置。注意系统使用的是当前时间的夏令时设置，而不是你正在设置的新的时间。因此，为保证正确的结果，第二次调用 SetLocalTime 函数，现在，第一次调用已经更新了夏令时设置了。


需求：

Minimum supported client	Windows 2000 专业版 [桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [桌面应用程序]
Header	Winbase.h (包含于 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

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