DownlevelLocaleNameToLCID 함수

로캘 이름을운영 체제에서 정보를 가져오는 데 사용할 수 있는 로캘 식별자로 변환합니다.

참고 항목

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

 

구문

LCID DownlevelLocaleNameToLCID(
  _In_ LPWSTR lpName,
  _In_ DWORD  dwFlags
);

매개 변수

lpName [in]

로캘 이름을 나타내는 null로 끝나는 문자열에 대한 포인터입니다.

dwFlags [in]

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

반환 값

성공하면 로캘 이름에 해당하는 로캘 식별자를 반환합니다.

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

• ERROR_INVALID_FLAGS. 플래그에 제공된 값이 잘못되었습니다.
• ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.

설명

참고 항목

이 함수는 중립 로캘을 지원하지 않습니다. 해당하는 LocaleNameToLCID 함수는 사용자 지정 로캘을 지원하지만 Windows Vista 이상에서는 지원합니다.

 

필요한 헤더 파일 및 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

참고 항목

국가별 언어 지원

국가별 언어 지원 함수

로캘 데이터 매핑

LocaleNameToLCID