Partilhar via

Função GetDistanceOfClosestLanguageInList (bcp47mrm.h)

  • Artigo

Determina a distância entre a marca de idioma especificada e a correspondência mais próxima em uma lista de idiomas.

Sintaxe

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

Parâmetros

pszLanguage

Tipo: PCWSTR

Uma marca de idioma BCP-47 que representa o idioma candidato.

pszLanguagesList

Tipo: PCWSTR

Uma lista delimitada por caracteres de marcas de idioma BCP-47 para comparar com o idioma candidato. Normalmente, essa é a lista de idiomas do usuário.

Se o parâmetro wchListDelimiter for L'\0', o pszLanguagesList será uma lista dupla terminada em nulo de marcas de idioma. Caso contrário, pszLanguagesList é uma cadeia de caracteres terminada em nulo na qual as marcas de idioma são separadas pelo delimitador fornecido.

wchListDelimiter

Tipo: wchar_t

O caractere usado como delimitador na lista de idiomas ou L'\0' para indicar que a lista de idiomas é uma lista terminada em nulo duplo. A função será um pouco mais eficiente se esse parâmetro for L'\0'.

pClosestDistance

Tipo: duplo

Recebe a distância entre o idioma candidato e o idioma mais próximo da lista. O valor está no intervalo de 0,0 a 1,0, em que 1,0 é uma correspondência exata.

Retornar valor

Tipo: HRESULT

Se não houver nenhuma correspondência com qualquer idioma na lista, a função retornará HRESULT_FROM_WIN32(ERROR_NO_MATCH) e uma distância de 0,0.

Comentários

Você pode usar essa função para localização para encontrar a correspondência mais próxima de um idioma candidato na lista de idiomas de usuário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 Build 17763
Servidor mínimo com suporte Windows 10 Build 17763
Cabeçalho bcp47mrm.h

Confira também

Marcas de idioma IsWellFormedTag, BCP-47