EnumDynamicTimeZoneInformation 函式 (timezoneapi.h)
列舉 DYNAMIC_TIME_ZONE_INFORMATION 儲存在登錄中的專案。 這項資訊可用來支援因日光節約時間調整而經歷年度界限變更的時區。 呼叫 GetDynamicTimeZoneInformationEffectiveYears 以擷取要傳遞至 GetTimeZoneInformationForYear 的特定年份範圍時，請使用此函式傳回的資訊。
語法
DWORD EnumDynamicTimeZoneInformation(
[in] const DWORD dwIndex,
[out] PDYNAMIC_TIME_ZONE_INFORMATION lpTimeZoneInformation
);
參數
[in] dwIndex
索引值，表示 DYNAMIC_TIME_ZONE_INFORMATION 專案的位置。
[out] lpTimeZoneInformation
指定時區和動態日光節約時間的設定。
傳回值
此函式會傳回 DWORD。 可能的傳回值包括：
| 值 | Description |
|---|---|
| ERROR_SUCCESS | 作業成功。 |
| ERROR_NO_MORE_ITEMS | 指定的索引不會再使用任何數據。 |
| ERROR_INVALID_PARAMETER | 有一個參數無效。 |
| 任何其他值 | 作業失敗。 |
備註
下列範例示範在傳回 ERROR_NO_MORE_ITEMS 之前，迴圈查看潛在的時區，表示登錄中沒有更多時區專案。
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);
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | timezoneapi.h (包含 Windows.h) |
| 程式庫 | advapi32.lib |
| Dll | advapi32.dll |