Функция 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
Header timezoneapi.h (включая Windows.h)
Библиотека advapi32.lib
DLL advapi32.dll

См. также раздел

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears