更新时间:2024-01-15 22:04
SetLocalTime是用来设置当前本地时间及日期。
SetLocalTime;
作用: 设置当前本地时间及日期。
语法:BOOL WINAPI SetLocalTime( _In_ constSYSTEMTIME *lpSystemTime);
参数: lpSystemTime 一个SYSTEMTIME结构的指针,包含了新的本地日期和时间。
SYSTEMTIME 结构wDayOfWeek成员被忽略。
返回值: 如果函数调用成功,则返回值为非零值。
如果函数失败,返回值是零。 为了得到扩展的错误信息,调用GetLastError函数 。
备注:
调用进程必须有权限的SE_SYSTEMTIME_NAME。 默认情况下禁用此权限。 SetLocalTime功能使SE_SYSTEMTIME_NAME的权限,然后再更改本地时间返回前和禁用的权限。 了解更多信息,请参阅运行特权 。
系统采用内部UTC。 因此,当你调用SetLocalTime,该系统采用当前时区信息进行转换,包括夏令时设置。 请注意,该系统采用夏令时设置当前时间,而不是设置新的时间。 因此,为了确保正确的结果,第二次调用SetLocalTime的第一次调用,现在已经更新夏令时设置。
SYSTEMTIME结构:
typedef struct _SYSTEMTIME {WORD wYear;WORD wMonth;WORD wDayOfWeek;WORD wDay;WORD wHour;WORD wMinute;WORD wSecond;WORD wMilliseconds;} SYSTEMTIME, *PSYSTEMTIME, *LPSYSTEMTIME;这个结构体是系统自定的,可以直接声明变量来使用
举例:
SYSTEMTIME curtime;//声明结构体变量;
curtime.wYear = 2013;//curtime.可以设置结构体内的值.
curtime.wMonth = 5;
curtime.wHour = 5;
curtime.wMinute = 10;
curtime.wSecond = 20;
//对结构体变量curtime的各项值分别赋值
SetLocalTime(&curtime);
//然后调用SetLocalTime设置时间.