enumDynamicTimeZoneInformation 函数 (timezoneapi.h)

  • 项目

枚举存储在注册表中的 DYNAMIC_TIME_ZONE_INFORMATION 项。 此信息用于支持由于夏令时调整而经历年度边界更改的时区。 使用此函数在调用 GetDynamicTimeZoneInformationEffectiveYears 时返回的信息检索要传递给 GetTimeZoneInformationForYear 的特定年份范围。

语法

DWORD EnumDynamicTimeZoneInformation(
  [in]  const DWORD                    dwIndex,
  [out] PDYNAMIC_TIME_ZONE_INFORMATION lpTimeZoneInformation
);

参数

[in] dwIndex

表示DYNAMIC_TIME_ZONE_INFORMATION项位置 的 索引值。

[out] lpTimeZoneInformation

指定时区和动态夏令时的设置。

返回值

此函数返回 DWORD。 可能的返回值包括：

值 说明
ERROR_SUCCESS 操作成功。
ERROR_NO_MORE_ITEMS 没有更多数据可用于给定索引。
ERROR_INVALID_PARAMETER 参数无效。
任何其他值 此操作失败。

注解

下面的示例演示了在返回 ERROR_NO_MORE_ITEMS 之前循环访问可能的时区，指示注册表中不再有时区条目。

std::vector<DYNAMIC_TIME_ZONE_INFORMATION> possibleTimezones;
DYNAMIC_TIME_ZONE_INFORMATION dynamicTimezone = {};
DWORD dwResult = 0;
DWORD i = 0;

do
{
    dwResult = EnumDynamicTimeZoneInformation(i++, &dynamicTimezone);
    if (dwResult == ERROR_SUCCESS)
    {
        possibleTimezones.push_back(dynamicTimezone);
    }
}
while (dwResult != ERROR_NO_MORE_ITEMS);

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 timezoneapi.h (包括 Windows.h)
Library advapi32.lib
DLL advapi32.dll

另请参阅

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears