SetLocalTime 函数 (sysinfoapi.h)
设置当前本地时间和日期。
语法
BOOL SetLocalTime(
[in] const SYSTEMTIME *lpSystemTime
);
参数
[in] lpSystemTime
指向包含新本地日期和时间的 SYSTEMTIME 结构的指针。
将忽略 SYSTEMTIME 结构的 wDayOfWeek 成员。
返回值
如果该函数成功，则返回值为非零值。
如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。
注解
调用进程必须具有SE_SYSTEMTIME_NAME特权。 默认情况下，此权限处于禁用状态。 SetLocalTime 函数在更改本地时间之前启用SE_SYSTEMTIME_NAME特权，并在返回之前禁用该特权。 有关详细信息，请参阅使用特殊特权运行。
系统在内部使用 UTC。 因此，调用 SetLocalTime 时，系统会使用当前时区信息来执行转换，包括夏令时设置。 请注意，系统使用当前时间的夏令时设置，而不是设置的新时间。 因此，为确保结果正确，请再次调用 SetLocalTime ，因为第一次调用已更新夏令时设置。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | sysinfoapi.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |