LCIDToLocaleName-Funktion (winnls.h)

Artikel
03/13/2024

Konvertiert einen Gebietsschemabezeichner in einen Gebietsschemanamen.

Hinweis Für benutzerdefinierte Gebietsschemas, einschließlich der von Microsoft erstellten, sollten Ihre Anwendungen Gebietsschemanamen gegenüber Gebietsschemabezeichnern bevorzugen.

Syntax

int LCIDToLocaleName(
  [in]            LCID   Locale,
  [out, optional] LPWSTR lpName,
  [in]            int    cchName,
  [in]            DWORD  dwFlags
);

Parameter

[in] Locale

Zu übersetzende Gebietsschemabezeichner. Sie können das MAKELCID-Makro verwenden, um einen Gebietsschemabezeichner zu erstellen oder einen der folgenden vordefinierten Werte zu verwenden.

Windows Vista: Die folgenden benutzerdefinierten Gebietsschemabezeichner werden ebenfalls unterstützt.

[out, optional] lpName

Zeiger auf einen Puffer, in dem diese Funktion den Gebietsschemanamen oder einen der folgenden vordefinierten Werte abruft.

[in] cchName

Größe des Gebietsschemanamenpuffers in Zeichen. Die maximal mögliche Länge eines Gebietsschemanamens, einschließlich eines abschließenden NULL-Zeichens, ist LOCALE_NAME_MAX_LENGTH. Dies ist die empfohlene Größe, die für diesen Parameter angegeben werden soll.

Alternativ kann die Anwendung diesen Parameter auf 0 festlegen. In diesem Fall gibt die Funktion die erforderliche Größe für den Gebietsschemanamenpuffer zurück.

[in] dwFlags

Vor Windows 7: Reserviert; sollte immer 0 sein.

Ab Windows 7: Kann auf LOCALE_ALLOW_NEUTRAL_NAMES festgelegt werden, um die Rückgabe eines neutralen Namens zu ermöglichen.

Rückgabewert

Gibt die Anzahl der Zeichen im Gebietsschemanamen zurück, einschließlich des abschließenden NULL-Zeichens, falls erfolgreich. Wenn die Funktion erfolgreich ist und der Wert von cchName 0 ist, entspricht der Rückgabewert der erforderlichen Größe in Zeichen (einschließlich NULL) für den Gebietsschemanamenpuffer.

Die Funktion gibt 0 zurück, wenn sie nicht erfolgreich ist. Um erweiterte Fehlerinformationen zu erhalten, 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.
ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winnls.h (windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

LocaleNameToLCID

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen

Freigeben über