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 |