小甲鱼 发表于 2016-5-18 17:12:08

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]
查看完整版本: SetLocalTime