EnumDynamicTimeZoneInformation-Funktion (timezoneapi.h)

Listet DYNAMIC_TIME_ZONE_INFORMATION einträge auf, die in der Registrierung gespeichert sind. Diese Informationen werden verwendet, um Zeitzonen zu unterstützen, in denen jährliche Begrenzungsänderungen aufgrund von Sommerzeitanpassungen auftreten. Verwenden Sie die von dieser Funktion zurückgegebenen Informationen, wenn Sie GetDynamicTimeZoneInformationEffectiveYears aufrufen, um den bestimmten Zeitraum von Jahren abzurufen, der an GetTimeZoneInformationForYear übergeben werden soll.

Syntax

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

Parameter

[in] dwIndex

Indexwert, der den Speicherort eines DYNAMIC_TIME_ZONE_INFORMATION-Eintrags darstellt.

[out] lpTimeZoneInformation

Gibt Einstellungen für eine Zeitzone und dynamische Sommerzeit an.

Rückgabewert

Diese Funktion gibt DWORD zurück. Mögliche Rückgabewerte sind:

Hinweise

Das folgende Beispiel veranschaulicht das Durchlaufen der potenziellen Zeitzonen, bis ERROR_NO_MORE_ITEMS zurückgegeben wird. Dies bedeutet, dass keine Zeitzoneneinträge mehr in der Registrierung vorhanden sind.

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

Anforderungen

Weitere Informationen

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears