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 を返します。 可能な戻り値は次のとおりです。

値	説明
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 を含む)
Library	advapi32.lib
[DLL]	advapi32.dll

こちらもご覧ください

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears