Функция 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 |