Fonction EnumDynamicTimeZoneInformation (timezoneapi.h)
É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 |