Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 |