Fungsi EnumDynamicTimeZoneInformation (timezoneapi.h)

Menghitung entri DYNAMIC_TIME_ZONE_INFORMATION yang disimpan dalam registri. Informasi ini digunakan untuk mendukung zona waktu yang mengalami perubahan batas tahunan karena penyesuaian waktu musim panas. Gunakan informasi yang dikembalikan oleh fungsi ini saat memanggil GetDynamicTimeZoneInformationEffectiveYears untuk mengambil rentang tahun tertentu untuk diteruskan ke GetTimeZoneInformationForYear.

Sintaks

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

Parameter

[in] dwIndex

Nilai indeks yang mewakili lokasi entri DYNAMIC_TIME_ZONE_INFORMATION .

[out] lpTimeZoneInformation

Menentukan pengaturan untuk zona waktu dan waktu musim panas dinamis.

Nilai kembali

Fungsi ini mengembalikan DWORD. Kemungkinan nilai yang dikembalikan meliputi:

Nilai	Deskripsi
ERROR_SUCCESS	Operasi berhasil.
ERROR_NO_MORE_ITEMS	Tidak ada lagi data yang tersedia untuk indeks yang diberikan.
ERROR_INVALID_PARAMETER	Parameter tidak valid.
Nilai lainnya	Operasi gagal.

Keterangan

Contoh berikut menunjukkan perulangan melalui zona waktu potensial hingga ERROR_NO_MORE_ITEMS dikembalikan, menunjukkan bahwa tidak ada lagi entri zona waktu dalam registri.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	timezoneapi.h (termasuk Windows.h)
Pustaka	advapi32.lib
DLL	advapi32.dll

Lihat juga

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears