DownlevelLCIDToLocaleName-Funktion
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 |
|
| DLL |
|
Siehe auch