EnumDynamicTimeZoneInformation-Funktion (timezoneapi.h)

  • Artikel

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:

Wert BESCHREIBUNG
ERROR_SUCCESS Der Vorgang wurde erfolgreich ausgeführt.
ERROR_NO_MORE_ITEMS Für den angegebenen Index sind keine weiteren Daten verfügbar.
ERROR_INVALID_PARAMETER Ein Parameter ist ungültig.
Ein beliebiger anderer Wert. Fehler beim Vorgang.

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile timezoneapi.h (Einschließen von Windows.h)
Bibliothek advapi32.lib
DLL advapi32.dll

Weitere Informationen

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears