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 で終わる 2 つのリストです。 それ以外の場合、 pszLanguagesList は null で終わる文字列であり、言語タグは指定された区切り記号で区切られます。

wchListDelimiter

種類: wchar_t

言語リストの区切り記号として使用される文字、または L'\0' 言語リストが null で終わる 2 つのリストであることを示す文字。 このパラメーターが の場合、関数の方が若干効率的です L'\0'。

pClosestDistance

型: double

候補言語とリスト内の最も近い言語の間の距離を受け取ります。 値の範囲は 0.0 から 1.0 で、1.0 は完全一致です。

戻り値

型: HRESULT

リスト内のどの言語にも一致しない場合、関数は を返し、0.0 の距離を返 HRESULT_FROM_WIN32(ERROR_NO_MATCH) します。

注釈

ローカライズにこの関数を使用すると、ユーザー言語の一覧で候補言語に最も近い一致を検索できます。

要件

こちらもご覧ください

IsWellFormedTag、 BCP-47 言語タグ