GetDynamicTimeZoneInformationEffectiveYears function

Gets a range, expressed in years, for which a DYNAMIC_TIME_ZONE_INFORMATION has valid entries. Use the returned value to identify the specific years to request when calling GetTimeZoneInformationForYear to retrieve time zone information for a time zone that experiences annual boundary changes due to daylight saving time adjustments.

Syntax

DWORD GetDynamicTimeZoneInformationEffectiveYears(
  const PDYNAMIC_TIME_ZONE_INFORMATION lpTimeZoneInformation,
  LPDWORD                              FirstYear,
  LPDWORD                              LastYear
);

Parameters

lpTimeZoneInformation

Specifies settings for a time zone and dynamic daylight saving time.

FirstYear

The year that marks the beginning of the range to pass to GetTimeZoneInformationForYear.

LastYear

The year that marks the end of the range to pass to GetTimeZoneInformationForYear.

Return Value

Return code/value Description
ERROR_SUCCESS
The operation succeeded.
ERROR_FILE_NOT_FOUND
The system cannot find the effective years.
ERROR_INVALID_PARAMETER
One of the parameter values is not valid.
Any other value
The operation failed.

Requirements

   
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header timezoneapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

DYNAMIC_TIME_ZONE_INFORMATION

EnumDynamicTimeZoneInformation