Función GetDistanceOfClosestLanguageInList (bcp47mrm.h)

Determina la distancia entre la etiqueta de idioma especificada y la coincidencia más cercana en una lista de idiomas.

Sintaxis

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

Parámetros

pszLanguage

Tipo: PCWSTR

Etiqueta de idioma BCP-47 que representa el idioma candidato.

pszLanguagesList

Tipo: PCWSTR

Lista delimitada por caracteres de etiquetas de idioma BCP-47 que se comparan con el idioma candidato. Normalmente, esta es la lista de idiomas de usuario.

Si el parámetro wchListDelimiter es L'\0', pszLanguagesList es una lista doble terminada en null de etiquetas de idioma. De lo contrario, pszLanguagesList es una cadena terminada en null en la que las etiquetas de idioma están separadas por el delimitador proporcionado.

wchListDelimiter

Tipo: wchar_t

Carácter utilizado como delimitador en la lista de idiomas o L'\0' para indicar que la lista de idiomas es una lista terminada en null doble. La función es ligeramente más eficaz si este parámetro es L'\0'.

pClosestDistance

Tipo: double

Recibe la distancia entre el idioma candidato y el idioma más cercano de la lista. El valor está en el intervalo de 0,0 a 1,0, donde 1,0 es una coincidencia exacta.

Valor devuelto

Tipo: HRESULT

Si no hay ninguna coincidencia con ningún idioma de la lista, la función devuelve HRESULT_FROM_WIN32(ERROR_NO_MATCH) y una distancia de 0,0.

Comentarios

Puede usar esta función para la localización para buscar la coincidencia más cercana a un idioma candidato en la lista de idiomas de usuario.

Requisitos

Requisito	Value
Cliente mínimo compatible	compilación 17763 de Windows 10
Servidor mínimo compatible	compilación 17763 de Windows 10
Encabezado	bcp47mrm.h

Consulte también

IsWellFormedTag, etiquetas de idioma BCP-47