DownlevelLCIDToLocaleName 함수

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

참고 항목

이 함수는 Windows Vista 이전 운영 체제에서 실행되는 애플리케이션에서만 사용됩니다. 사용하려면 다운로드 패키지가 필요합니다. Windows Vista 이상에서만 실행되는 애플리케이션은 LCIDToLocaleName을 호출하여 로캘 이름을 검색해야 합니다.

 

구문

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

매개 변수

로캘 [in]

번역할 로캘 식별자입니다. MAKELCID 매크로를 사용하여 로캘 식별자를 만들 수 있습니다. 이 함수는 중립 로캘 또는 다음 특정 로캘 식별자 값을 지원하지 않습니다.

• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT
• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

lpName [out]

이 함수가 로캘 이름을 검색하는 버퍼에 대한 포인터입니다. cchName이 0으로 설정된 경우 함수는 NULL을 검색합니다.

cchName [in]

로캘 이름 버퍼의 크기(UTF-16 코드 포인트)입니다. 애플리케이션은 로캘 이름 버퍼의 필요한 크기를 반환하기 위해 이 매개 변수를 0으로 설정합니다.

dwFlags [in]

검색할 이름 유형을 지정하는 플래그입니다. 기본값은 DOWNLEVEL_LOCALE_NAME.

반환 값

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

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

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

설명

참고 항목

이 함수는 사용자 지정 로캘을 지원하지 않습니다.

 

필요한 헤더 파일 및 DLL은 Microsoft 다운로드 센터에서 더 이상 사용할 수 없는 "Microsoft NLS 다운레벨 데이터 매핑 API" 다운로드의 일부입니다. Windows 10 2019년 5월 업데이트 이상 버전에서 ICU 세계화 API를 사용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
재배포 가능 파일	MICROSOFT NLS Downlevel Data Mapping API onWindows XP with SP2 and laterorWindows Vista
헤더	Nlsdl.h
DLL	NlsMap.dll

참고 항목

국가별 언어 지원

국가별 언어 지원 함수

로캘 데이터 매핑

LCIDToLocaleName