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