Compartilhar via

Função EnumDynamicTimeZoneInformation (timezoneapi.h)

  • Artigo

Enumera DYNAMIC_TIME_ZONE_INFORMATION entradas armazenadas no registro. Essas informações são usadas para dar suporte a fusos horários que experimentam alterações de limite anuais devido a ajustes de horário de verão. Use as informações retornadas por essa função ao chamar GetDynamicTimeZoneInformationEffectiveYears para recuperar o intervalo específico de anos a ser passado para GetTimeZoneInformationForYear.

Sintaxe

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

Parâmetros

[in] dwIndex

Valor de índice que representa o local de uma entrada de DYNAMIC_TIME_ZONE_INFORMATION .

[out] lpTimeZoneInformation

Especifica as configurações para um fuso horário e horário de verão dinâmico.

Retornar valor

Essa função retorna DWORD. Os possíveis valores retornados incluem:

Valor Descrição
ERROR_SUCCESS A operação foi realizada com êxito.
ERROR_NO_MORE_ITEMS Não há mais dados disponíveis para o índice fornecido.
ERROR_INVALID_PARAMETER Um parâmetro é inválido.
Qualquer outro valor Falha na operação.

Comentários

O exemplo a seguir demonstra o loop dos fusos horários potenciais até que ERROR_NO_MORE_ITEMS seja retornado, indicando que não há mais entradas de fuso horário no registro.

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);

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho timezoneapi.h (inclua Windows.h)
Biblioteca advapi32.lib
DLL advapi32.dll

Confira também

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears