ResolveLocaleName 함수(winnls.h)

  • 아티클

제공된 이름에 대해 가능한 로캘 이름 일치를 찾습니다.

구문

int ResolveLocaleName(
  [in, optional]  LPCWSTR lpNameToResolve,
  [out, optional] LPWSTR  lpLocaleName,
  [in]            int     cchLocaleName
);

매개 변수

[in, optional] lpNameToResolve

resolve 이름(예: 영어의 경우 "en-XA")에 대한 포인터입니다(개인용).

[out, optional] lpLocaleName

이 함수가 입력 이름과 일치하는 로캘 이름을 검색하는 버퍼에 대한 포인터입니다. 예를 들어 이름 "en-XA"의 일치 항목은 영어(미국)의 경우 "en-US"입니다.

참고 함수가 실패하면 출력 버퍼의 상태가 정확하지 않습니다. 이 경우 애플리케이션은 함수에서 설정한 반환 값 및 오류 상태 검사 올바른 작업 과정을 결정해야 합니다.
 

[in] cchLocaleName

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

반환 값

성공하면 종료 null 문자를 포함하여 로캘 이름을 포함하는 버퍼의 크기를 반환합니다.

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

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

설명

검색된 로캘 이름은 입력 언어가 중립적이더라도 언어 및 국가/지역을 포함한 특정 로캘을 나타냅니다. 예를 들어 영어(미국)에 대해 "en"을 입력하면 함수가 "en-US"를 검색합니다.

이 함수는 사용자 지정 로캘에서 데이터를 검색할 수 있습니다. 데이터는 컴퓨터에서 컴퓨터로 또는 애플리케이션 실행 간에 동일하지 않으며 유효한 로캘 반환이 다른 컴퓨터에서 유효하다는 보장도 하지 않습니다. 애플리케이션이 데이터를 유지하거나 전송해야 하는 경우 영구 로캘 데이터 사용을 참조하세요.

Windows 8부터:Windows.Globalization 네임스페이스에서 가져온 언어 태그는 ResolveLocaleName 에서 변환해야 국가별 언어 지원 함수와 함께 사용할 수 있습니다.

요구 사항

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

참고 항목

국가 언어 지원

국가 언어 지원 기능

Windows.Globalization