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 포함)
라이브러리	advapi32.lib
DLL	advapi32.dll

추가 정보

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformationEffectiveYears