DownlevelLCIDToLocaleName-Funktion

Artikel
12/29/2023

Konvertiert einen Gebietsschemabezeichner in einen Gebietsschemanamen.

Hinweis

Diese Funktion wird nur von Anwendungen verwendet, die unter älteren Betriebssystemen als Windows Vista ausgeführt werden. Ihre Verwendung erfordert das Downloadpaket. Anwendungen, die nur unter Windows Vista und höher ausgeführt werden, sollten LCIDToLocaleName aufrufen, um einen Gebietsschemanamen abzurufen.

Syntax

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

Parameter

Locale [in]

Der zu übersetzende Gebietsschemabezeichner. Sie können das Makro MAKELCID verwenden, um einen Gebietsschemabezeichner zu erstellen. Diese Funktion unterstützt keine neutralen Gebietsschemas oder die folgenden speziellen Gebietsschema-ID-Werte.

lpName [out]

Zeiger auf einen Puffer, in dem diese Funktion den Gebietsschemanamen abruft. Die Funktion ruft NULL ab, wenn cchName auf 0 festgelegt ist.

cchName [in]

Größe des Gebietsschemanamenpuffers in UTF-16-Codepunkten. Die Anwendung legt diesen Parameter auf 0 fest, um die erforderliche Größe des Gebietsschemanamenpuffers zurückzugeben.

dwFlags [in]

Flags, die den Typ des abzurufenden Namens angeben. Der Standardwert lautet DOWNLEVEL_LOCALE_NAME.

Rückgabewert

Gibt die Anzahl der UTF-16-Codepunkte im Gebietsschemanamen zurück, einschließlich des endenden Nullzeichens, falls erfolgreich. Wenn die Funktion erfolgreich ausgeführt wird und der Wert von cchScripts 0 ist, enthält der Rückgabewert die erforderliche Größe des Puffers für den Gebietsschemanamen in Zeichen (einschließlich Nullzeichen).

Diese Funktion gibt 0 zurück, wenn sie nicht erfolgreich ausgeführt wird. Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastError aufrufen, sodass einer der folgenden Fehlercodes zurückgegeben werden kann:

ERROR_INSUFFICIENT_BUFFER. Die angegebene Puffergröße war nicht ausreichend, oder sie wurde fälschlicherweise auf NULL festgelegt.
ERROR_INVALID_FLAGS. Der Wert von dwFlags ist ungültig.
ERROR_INVALID_PARAMETER. Ein Parameterwert war ungültig.

Hinweise

Hinweis

Diese Funktion unterstützt keine benutzerdefinierten Gebietsschemas.

Die erforderliche Headerdatei und die DLL-Datei sind Teil des Downloads „Microsoft NLS Downlevel Data Mapping APIs“, der im Microsoft Download Center nicht mehr verfügbar ist. Verwenden Sie ICU-Globalisierungs-APIs unter Windows 10, Update Mai 2019 und höheren Versionen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Verteilbar	Microsoft NLS Downlevel Data Mapping APIs unter Windows XP mit SP2 und höher oder Windows Vista
Header	Nlsdl.h
DLL	NlsMap.dll

Siehe auch

Unterstützung der Landessprache
Funktionen zur Unterstützung der Landessprache
Zuordnen von Gebietsschemadaten
LCIDToLocaleName