Функция 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

Если в списке нет совпадений ни с каким языком, функция возвращает HRESULT_FROM_WIN32(ERROR_NO_MATCH) и расстояние 0,0.

Комментарии

Эту функцию можно использовать для локализации, чтобы найти ближайшее совпадение с языком-кандидатом в списке языков пользователя.

Требования

Требование Значение
Минимальная версия клиента сборка Windows 10 17763
Минимальная версия сервера сборка Windows 10 17763
Верхняя часть bcp47mrm.h

См. также раздел

Теги языка IsWellFormedTag, BCP-47