Funzione GetDistanceOfClosestLanguageInList (bcp47mrm.h)

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 fornito.

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 nessun linguaggio nell'elenco, la funzione restituisce HRESULT_FROM_WIN32(ERROR_NO_MATCH) e una distanza di 0,0.

Osservazioni:

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

Requisiti

Vedere anche

Tag di lingua IsWellFormedTag, BCP-47