SetLocalTime

原文链接 -> 传送门

函数功能：

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


API 函数原型：

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

BOOL WINAPI SetLocalTime(
  _In_ const SYSTEMTIME *lpSystemTime
);

参数解析：

返回值：

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

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

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


备注：

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

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


需求：