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 |