Funzione EnumDynamicTimeZoneInformation (timezoneapi.h)

Articolo
08/26/2023

Enumera DYNAMIC_TIME_ZONE_INFORMATION voci archiviate nel Registro di sistema. Queste informazioni vengono usate per supportare i fusi orari che riscontrano modifiche annuali al limite dovuto alle regolazioni dell'ora legale. Usare le informazioni restituite da questa funzione quando si chiama GetDynamicTimeZoneInformationEffectiveYears per recuperare l'intervallo di anni specifico da passare a GetTimeZoneInformationForYear.

Sintassi

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

Parametri

[in] dwIndex

Valore di indice che rappresenta la posizione di una voce DYNAMIC_TIME_ZONE_INFORMATION .

[out] lpTimeZoneInformation

Specifica le impostazioni per un fuso orario e l'ora legale dinamica.

Valore restituito

Questa funzione restituisce DWORD. I valori restituiti possibili includono:

Valore	Descrizione
ERROR_SUCCESS	Operazione completata.
ERROR_NO_MORE_ITEMS	Non sono più disponibili dati per l'indice specificato.
ERROR_INVALID_PARAMETER	Un parametro non è valido.
Qualsiasi altro valore	Operazione non riuscita.

Commenti

Nell'esempio seguente viene illustrato il ciclo dei potenziali fuso orario fino a quando non viene restituito ERROR_NO_MORE_ITEMS , che indica che non sono presenti più voci del fuso orario nel Registro di sistema.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	timezoneapi.h (include Windows.h)
Libreria	advapi32.lib
DLL	advapi32.dll

Vedi anche

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears

Condividi tramite