SetTimeZoneInformation (Compact 2013)
3/28/2014
This function sets the current time-zone parameters. These parameters control translations from UTC to local time.
Syntax
BOOL SetTimeZoneInformation(
const TIME_ZONE_INFORMATION* lpTimeZoneInformation
);
Parameters
- lpTimeZoneInformation
[in] Pointer to a TIME_ZONE_INFORMATION structure that contains the time-zone parameters to set.
Return Value
Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.
Remarks
SetTimeZoneInformation does not save the newly written data into the persistent registry. To write the data permanently, you need to make the following call: RegFlushKey(HKEY_LOCAL_MACHINE). For more information, see RegFlushKey.
All translations between UTC and local time are based on the following formula:
UTC = local time + bias
The bias is the difference, in minutes, between UTC and local time.
SetTimeZoneInformation changes the clock to reflect the change in bias. However, GetLocalTime may not immediately reflect changes made from non-DST zones to DST zones (and vice-versa). Changes will appear once the system time service properly adjusts the clock based on the new DST status.
The Dynamic DST service updates the time zone information based on the Id of the time zone. SetTimeZoneInformation does not specify the Id of time zone, causing the Dynamic DST service to stop functioning properly. You should use
SetTimeZoneInformationByID instead of SetTimeZoneInformation.
Requirements
Header |
winbase.h |
Library |
coredll.lib |
See Also
Reference
Time Functions
GetLocalTime
GetSystemTime
GetTimeZoneInformation
TIME_ZONE_INFORMATION