Compartir a través de

Función EnumDynamicTimeZoneInformation (timezoneapi.h)

  • Artículo

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