SetDynamicTimeZoneInformation function (timezoneapi.h)

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(
  [in] const DYNAMIC_TIME_ZONE_INFORMATION *lpTimeZoneInformation
);

Parameters

[in] 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

See also

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformation

Time Functions