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 |