Share via

GetDistanceOfClosestLanguageInList 함수(bcp47mrm.h)

  • 아티클

지정된 언어 태그와 언어 목록에서 가장 가까운 일치 항목 사이의 거리를 결정합니다.

구문

HRESULT GetDistanceOfClosestLanguageInList(
  PCWSTR  pszLanguage,
  PCWSTR  pszLanguagesList,
  wchar_t wchListDelimiter,
  double  *pClosestDistance
);

매개 변수

pszLanguage

형식: PCWSTR

후보 언어를 나타내는 BCP-47 언어 태그입니다.

pszLanguagesList

형식: PCWSTR

후보 언어와 비교할 BCP-47 언어 태그의 문자로 구분된 목록입니다. 일반적으로 사용자 언어 목록입니다.

wchListDelimiter 매개 변수가 L'\0'이면 pszLanguagesList는 이중 null로 끝나는 언어 태그 목록입니다. 그렇지 않으면 pszLanguagesList 는 언어 태그가 제공된 구분 기호로 구분되는 null로 끝나는 문자열입니다.

wchListDelimiter

형식: wchar_t

언어 목록에서 구분 기호로 사용되거나 L'\0' 언어 목록이 이중 null로 끝나는 목록임을 나타내는 문자입니다. 이 매개 변수가 인 경우 함수가 약간 더 효율적입니다 L'\0'.

pClosestDistance

형식: double

목록에서 후보 언어와 가장 가까운 언어 사이의 거리를 받습니다. 값은 0.0에서 1.0까지의 범위에 있습니다. 여기서 1.0은 정확히 일치합니다.

반환 값

형식: HRESULT

목록에 있는 언어와 일치하지 않는 경우 함수는 0.0의 거리를 반환 HRESULT_FROM_WIN32(ERROR_NO_MATCH) 합니다.

설명

지역화에 이 함수를 사용하여 사용자 언어 목록에서 후보 언어와 가장 일치하는 항목을 찾을 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 빌드 17763
지원되는 최소 서버 Windows 10 빌드 17763
머리글 bcp47mrm.h

추가 정보

IsWellFormedTag, BCP-47 언어 태그