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 |