SetLocalTime
注:本文档由 Diu 翻译,小甲鱼校对。原文链接 -> 传送门
函数功能:
SetLocalTime 函数用于设置当前的本地时间与日期。
API 函数原型:
注释:_In_ 说明该参数是输入的。
BOOL WINAPI SetLocalTime(
_In_ const SYSTEMTIME *lpSystemTime
);
参数解析:
参数 含义
lpSystemTime1. 指向将获取当前本地日期和时间的 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)所有,转载请注明来源。
页:
[1]