SetDynamicTimeZoneInformation function

Sets the current time zone and dynamic daylight saving time settings. These settings control translations from Coordinated Universal Time (UTC) to local time.

Syntax

BOOL SetDynamicTimeZoneInformation(
  const DYNAMIC_TIME_ZONE_INFORMATION *lpTimeZoneInformation
);

Parameters

lpTimeZoneInformation

A pointer to a DYNAMIC_TIME_ZONE_INFORMATION structure.

Return Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

An application must have the SE_TIME_ZONE_NAME privilege for this function to succeed. This privilege is disabled by default. Use the AdjustTokenPrivileges function to enable the privilege before calling SetDynamicTimeZoneInformation, and then to disable the privilege after the SetDynamicTimeZoneInformation call. For more information, see Running with Special Privileges.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header timezoneapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformation

Time Functions