LCIDToLocaleName 함수(winnls.h)

로캘 식별자를 로캘 이름으로 변환합니다.

참고 Microsoft에서 만든 로캘을 포함하여 사용자 지정 로캘의 경우 애플리케이션은 로캘 식별자보다 로캘 이름을 선호해야 합니다.

 

구문

int LCIDToLocaleName(
  [in]            LCID   Locale,
  [out, optional] LPWSTR lpName,
  [in]            int    cchName,
  [in]            DWORD  dwFlags
);

매개 변수

[in] Locale

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

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

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

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

[out, optional] lpName

이 함수가 로캘 이름 또는 다음 미리 정의된 값 중 하나를 검색하는 버퍼에 대한 포인터입니다.

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

[in] cchName

로캘 이름 버퍼의 크기(문자)입니다. 종료 null 문자를 포함하여 로캘 이름의 가능한 최대 길이는 LOCALE_NAME_MAX_LENGTH. 이 매개 변수에 제공하는 권장 크기입니다.

또는 애플리케이션에서 이 매개 변수를 0으로 설정할 수 있습니다. 이 경우 함수는 로캘 이름 버퍼에 필요한 크기를 반환합니다.

[in] dwFlags

Windows 7 이전: 예약; 는 항상 0이어야 합니다.

Windows 7부터: 중립 이름의 반환을 허용하도록 LOCALE_ALLOW_NEUTRAL_NAMES 설정할 수 있습니다.

반환 값

성공하면 로캘 이름에 종료 null 문자를 포함하여 문자 수를 반환합니다. 함수가 성공하고 cchName 값이 0이면 로캘 이름 버퍼에 필요한 크기(null 포함)입니다.

함수가 성공하지 못하면 0을 반환합니다. 확장된 오류 정보를 가져오기 위해 애플리케이션은 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError를 호출할 수 있습니다.

• ERROR_INSUFFICIENT_BUFFER. 제공된 버퍼 크기가 충분히 크지 않거나 NULL로 잘못 설정되었습니다.
• ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.

요구 사항

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

참고 항목

LocaleNameToLCID

국가 언어 지원

국가 언어 지원 함수