Función EnumDynamicTimeZoneInformation (timezoneapi.h)

Enumera DYNAMIC_TIME_ZONE_INFORMATION entradas almacenadas en el registro. Esta información se usa para admitir zonas horarias que experimentan cambios de límites anuales debido a los ajustes del horario de verano. Use la información devuelta por esta función al llamar a GetDynamicTimeZoneInformationEffectiveYears para recuperar el intervalo específico de años que se pasará a GetTimeZoneInformationForYear.

Sintaxis

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

Parámetros

[in] dwIndex

Valor de índice que representa la ubicación de una entrada de DYNAMIC_TIME_ZONE_INFORMATION .

[out] lpTimeZoneInformation

Especifica la configuración de una zona horaria y el horario de verano dinámico.

Valor devuelto

Esta función devuelve DWORD. Entre los posibles valores devueltos se incluyen:

Valor	Descripción
ERROR_SUCCESS	La operación se realizó correctamente.
ERROR_NO_MORE_ITEMS	No hay más datos disponibles para el índice especificado.
ERROR_INVALID_PARAMETER	Si se devuelve este valor, significará que el parámetro en cuestión no es válido.
Cualquier otro valor	Error en la operación.

Comentarios

En el ejemplo siguiente se muestra cómo recorrer en bucle las posibles zonas horarias hasta que se devuelve ERROR_NO_MORE_ITEMS , lo que indica que no hay más entradas de zona horaria en el 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	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	timezoneapi.h (incluir Windows.h)
Library	advapi32.lib
Archivo DLL	advapi32.dll

Consulte también

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears