GetDistanceOfClosestLanguageInList-Funktion (bcp47mrm.h)

Bestimmt den Abstand zwischen dem angegebenen Sprachtag und der nächstgelegenen Übereinstimmung in einer Liste von Sprachen.

Syntax

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

Parameter

pszLanguage

Typ: PCWSTR

Ein BCP-47-Sprachtag , das die Kandidatensprache darstellt.

pszLanguagesList

Typ: PCWSTR

Eine durch Zeichen getrennte Liste von BCP-47-Sprachtags , die mit der Kandidatensprache verglichen werden sollen. Dies ist in der Regel die Liste der Benutzersprachen.

Wenn der wchListDelimiter-Parameter ist L'\0', ist pszLanguagesList eine liste mit doppelten NULL-Terminen von Sprachtags. Andernfalls ist pszLanguagesList eine null-endende Zeichenfolge, in der die Sprachtags durch das bereitgestellte Trennzeichen getrennt werden.

wchListDelimiter

Typ: wchar_t

Das Zeichen, das als Trennzeichen in der Sprachliste verwendet wird, oder L'\0' um anzugeben, dass die Sprachliste eine liste mit doppeltem NULL-Ende ist. Die Funktion ist etwas effizienter, wenn dieser Parameter ist L'\0'.

pClosestDistance

Typ: double

Empfängt den Abstand zwischen der Kandidatensprache und der nächstgelegenen Sprache in der Liste. Der Wert liegt im Bereich von 0,0 bis 1,0, wobei 1,0 eine genaue Übereinstimmung ist.

Rückgabewert

Typ: HRESULT

Wenn keine Übereinstimmung mit einer Sprache in der Liste vorhanden ist, gibt die Funktion einen Abstand von 0,0 zurück HRESULT_FROM_WIN32(ERROR_NO_MATCH) .

Hinweise

Sie können diese Funktion für die Lokalisierung verwenden, um die nächstgelegene Übereinstimmung mit einer Kandidatensprache in der Liste der Benutzersprachen zu finden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 Build 17763
Unterstützte Mindestversion (Server)	Windows 10 Build 17763
Kopfzeile	bcp47mrm.h

Weitere Informationen

IsWellFormedTag, BCP-47-Sprachtags