GetDistanceOfClosestLanguageInList, fonction (bcp47mrm.h)

Article
03/06/2024

Détermine la distance entre la balise de langue spécifiée et la correspondance la plus proche dans une liste de langues.

Syntaxe

HRESULT GetDistanceOfClosestLanguageInList(
  PCWSTR  pszLanguage,
  PCWSTR  pszLanguagesList,
  wchar_t wchListDelimiter,
  double  *pClosestDistance
);

Paramètres

pszLanguage

Type : PCWSTR

Balise de langue BCP-47 qui représente la langue candidate.

pszLanguagesList

Type : PCWSTR

Liste délimitée par des caractères de balises de langue BCP-47 à comparer à la langue candidate. Il s’agit généralement de la liste des langues utilisateur.

Si le paramètre wchListDelimiter est L'\0', le pszLanguagesList est une double liste null de balises de langue. Sinon, pszLanguagesList est une chaîne terminée par null dans laquelle les balises de langue sont séparées par le délimiteur fourni.

wchListDelimiter

Type : wchar_t

Caractère utilisé comme délimiteur dans la liste des langues ou L'\0' pour indiquer que la liste de langues est une liste avec double fin null. La fonction est légèrement plus efficace si ce paramètre est L'\0'.

pClosestDistance

Type : double

Reçoit la distance entre la langue candidate et la langue la plus proche de la liste. La valeur est comprise entre 0,0 et 1,0, où 1.0 correspond exactement.

Valeur retournée

Type : HRESULT

S’il n’y a aucune correspondance avec une langue dans la liste, la fonction retourne HRESULT_FROM_WIN32(ERROR_NO_MATCH) et une distance de 0,0.

Remarques

Vous pouvez utiliser cette fonction pour la localisation afin de trouver la correspondance la plus proche d’une langue candidate dans la liste des langues utilisateur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 17763
Serveur minimal pris en charge	Windows 10 Build 17763
En-tête	bcp47mrm.h

Voir aussi

Balises de langue IsWellFormedTag, BCP-47

Partager via