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语言标记