ResolveLocaleName-Funktion (winnls.h)

Artikel
08/27/2023

Sucht eine mögliche Übereinstimmung mit dem Gebietsschemanamen für den angegebenen Namen.

Syntax

int ResolveLocaleName(
  [in, optional]  LPCWSTR lpNameToResolve,
  [out, optional] LPWSTR  lpLocaleName,
  [in]            int     cchLocaleName
);

Parameter

[in, optional] lpNameToResolve

Zeiger auf einen Namen, der aufgelöst werden soll, z. B. "en-XA" für Englisch (Private Use).

[out, optional] lpLocaleName

Zeiger auf einen Puffer, in dem diese Funktion den Gebietsschemanamen abruft, der dem Eingabenamen entspricht. Die Übereinstimmung für den Namen "en-XA" ist beispielsweise "en-US" für Englisch (USA).

Hinweis Wenn die Funktion fehlschlägt, wird nicht garantiert, dass der Zustand des Ausgabepuffers richtig ist. In diesem Fall sollte die Anwendung den Rückgabewert und den Fehler überprüfen, status von der Funktion festgelegt werden, um die richtige Vorgehensweise zu bestimmen.

[in] cchLocaleName

Größe des Puffers, der von lpLocaleName angegeben wird, in Zeichen. Die maximal mögliche Länge eines Gebietsschemanamens, einschließlich eines beendenden NULL-Zeichens, ist der Wert von LOCALE_NAME_MAX_LENGTH. Dies ist die empfohlene Größe, die in diesem Parameter angegeben werden soll.

Rückgabewert

Gibt bei erfolgreicher Ausführung die Größe des Puffers zurück, der den Gebietsschemanamen enthält, einschließlich des beendenden NULL-Zeichens.

Die Funktion gibt 0 zurück, wenn sie nicht erfolgreich ist. Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastError aufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

ERROR_INSUFFICIENT_BUFFER. Eine angegebene Puffergröße war nicht groß genug, oder sie wurde fälschlicherweise auf NULL festgelegt.

Hinweise

Der abgerufene Gebietsschemaname gibt ein bestimmtes Gebietsschema an, einschließlich Sprache und Land/Region, auch wenn die Eingabesprache neutral ist. Beispielsweise bewirkt eine Eingabe von "en" für Englisch (USA), dass die Funktion "en-US" abruft.

Diese Funktion kann Daten aus benutzerdefinierten Gebietsschemas abrufen. Es ist nicht garantiert, dass die Daten von Computer zu Computer oder zwischen den Ausführungen einer Anwendung identisch sind, und die Rückgabe eines gültigen Gebietsschemas garantiert nicht, dass sie auf einem anderen Computer gültig sind. Wenn Ihre Anwendung Daten beibehalten oder übertragen muss, finden Sie weitere Informationen unter Verwenden persistenter Gebietsschemadaten.

Ab Windows 8: Sprachtags, die aus dem Windows.Globalization-Namespace abgerufen wurden, müssen von ResolveLocaleName konvertiert werden, bevor sie mit allen Nationalen Sprachunterstützungsfunktionen verwendet werden können.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winnls.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Unterstützung für nationale Sprachen

Nationale Sprachunterstützungsfunktionen

Windows.Globalization

Freigeben über