Fonction EnumDynamicTimeZoneInformation (timezoneapi.h)

  • Article

Énumère DYNAMIC_TIME_ZONE_INFORMATION entrées stockées dans le Registre. Ces informations sont utilisées pour prendre en charge les fuseaux horaires qui subissent des modifications de limites annuelles en raison des ajustements de l’heure d’été. Utilisez les informations retournées par cette fonction lors de l’appel de GetDynamicTimeZoneInformationEffectiveYears pour récupérer la plage spécifique d’années à passer à GetTimeZoneInformationForYear.

Syntaxe

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

Paramètres

[in] dwIndex

Valeur d’index qui représente l’emplacement d’une entrée DYNAMIC_TIME_ZONE_INFORMATION .

[out] lpTimeZoneInformation

Spécifie les paramètres d’un fuseau horaire et de l’heure d’été dynamique.

Valeur retournée

Cette fonction retourne DWORD. Les valeurs de retour possibles sont les suivantes :

Valeur Description
ERROR_SUCCESS L’opération a réussi.
ERROR_NO_MORE_ITEMS Plus aucune donnée n’est disponible pour l’index donné.
ERROR_INVALID_PARAMETER Un paramètre n'est pas valide.
Toute autre valeur L'opération a échoué.

Remarques

L’exemple suivant montre comment parcourir les fuseaux horaires potentiels jusqu’à ce que ERROR_NO_MORE_ITEMS soit retourné, indiquant qu’il n’y a plus d’entrées de fuseau horaire dans le Registre.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête timezoneapi.h (inclure Windows.h)
Bibliothèque advapi32.lib
DLL advapi32.dll

Voir aussi

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears