Funzione GetDistanceOfClosestLanguageInList (bcp47mrm.h)

Articolo
03/11/2023

Determina la distanza tra il tag di lingua specificato e la corrispondenza più vicina in un elenco di lingue.

Sintassi

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

Parametri

pszLanguage

Tipo: PCWSTR

Tag di lingua BCP-47 che rappresenta la lingua candidata.

pszLanguagesList

Tipo: PCWSTR

Elenco delimitato da caratteri di tag di lingua BCP-47 da confrontare con la lingua candidata. Si tratta in genere dell'elenco delle lingue utente.

Se il parametro wchListDelimiter è L'\0', pszLanguagesList è un doppio elenco di tag di lingua con terminazione Null. In caso contrario, pszLanguagesList è una stringa con terminazione Null in cui i tag di lingua sono separati dal delimitatore specificato.

wchListDelimiter

Tipo: wchar_t

Carattere utilizzato come delimitatore nell'elenco di lingue o L'\0' per indicare che l'elenco di lingue è un elenco con terminazione Null doppia. La funzione è leggermente più efficiente se questo parametro è L'\0'.

pClosestDistance

Tipo: double

Riceve la distanza tra la lingua candidata e la lingua più vicina nell'elenco. Il valore è compreso nell'intervallo compreso tra 0,0 e 1,0, dove 1,0 è una corrispondenza esatta.

Valore restituito

Tipo: HRESULT

Se non esiste alcuna corrispondenza con qualsiasi linguaggio nell'elenco, la funzione restituisce HRESULT_FROM_WIN32(ERROR_NO_MATCH) e una distanza pari a 0,0.

Commenti

È possibile usare questa funzione per la localizzazione per trovare la corrispondenza più vicina a una lingua candidata nell'elenco delle lingue utente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 Build 17763
Server minimo supportato	Windows 10 Build 17763
Intestazione	bcp47mrm.h

Vedi anche

IsWellFormedTag, tag di lingua BCP-47

Condividi tramite