ConvertDefaultLocale 함수(winnls.h)

아티클
08/27/2023

기본 로캘 값을 실제 로캘 식별자로 변환합니다.

참고 이 함수는 부분 로캘 식별자를 변환하는 경우에만 제공됩니다. 애플리케이션은 식별자 대신 로캘 이름을 사용해야 합니다. LCIDToLocaleName 함수를 사용하여 로캘 식별자를 유효한 로캘 이름으로 변환할 수 있습니다. 애플리케이션은 GetUserDefaultLocaleName을 사용하여 현재 사용자 로캘 이름을 검색할 수도 있습니다. GetSystemDefaultLocaleName을 사용하여 현재 시스템 로캘 이름을 검색합니다. 및 기본 상수를 포함하여 입력 로캘의 로캘 이름을 검색하는 데 LOCALE_SNAME 있는 GetLocaleInfoEx

구문

LCID ConvertDefaultLocale(
  [in] LCID Locale
);

매개 변수

[in] Locale

변환할 기본 로캘 식별자 값입니다. MAKELCID 매크로를 사용하여 로캘 식별자를 만들거나 다음 미리 정의된 값 중 하나를 사용할 수 있습니다.

Windows Vista 이상: 다음 사용자 지정 로캘 식별자도 지원됩니다.

반환 값

성공하면 적절한 로캘 식별자를 반환합니다.

이 함수는 성공하지 못하면 Locale 매개 변수의 값을 반환합니다. 로캘 값이 위에 나열된 기본값 중 하나가 아닌 경우 함수가 실패합니다.

설명

LOCALE_SYSTEM_DEFAULT 지정하는 ConvertDefaultLocale 호출은 GetSystemDefaultLCID 호출과 동일합니다. LOCALE_USER_DEFAULT 지정하는 ConvertDefaultLocale 호출은 GetUserDefaultLCID 호출과 동일합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winnls.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll