DownlevelGetParentLocaleName-Funktion
Ruft den Gebietsschemanamen für das übergeordnete Gebietsschema des angegebenen Gebietsschemas ab.
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 können, sollten GetLocaleInfo aufrufen, wobei LCType auf LOCALE_SPARENT festgelegt ist.
Syntax
int DownlevelGetParentLocaleName(
_In_ LCID Locale,
_Out_ LPWSTR lpName,
_In_ int cchName
);
Parameter
-
Gebietsschema [in]
-
Gebietsschemabezeichner des Gebietsschemas Sie können mit dem Makro MAKELCID einen Gebietsschemabezeichner erstellen oder einen der folgenden vordefinierten Werte verwenden.
Windows Vista und höher: Die folgenden benutzerdefinierten Gebietsschema-IDs werden ebenfalls unterstützt.
-
lpName [out]
-
Zeigen Sie auf einen Puffer, in den die Funktion den Namen des übergeordneten Gebietsschemas oder einen der folgenden vordefinierten Werte abruft. Dieser Parameter wird auf NULL festgelegt, wenn cchName auf 0 festgelegt ist.
-
cchName [in]
-
Größe des durch lpName angegebenen Puffers in UTF-16-Codepunkten. Ein Wert von 0 für diesen Parameter veranlasst die Funktion, den Puffer lpName zu ignorieren und die Größe des Puffers in Zeichen (einschließlich Nullzeichen) zurückzugeben, die zur Aufnahme des Namen des übergeordneten Gebietsschemas erforderlich ist.
Rückgabewert
Gibt die Anzahl der UTF-16-Codepunkte im Gebietsschemanamen zurück, einschließlich des endenden Nullzeichens, falls erfolgreich.
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_PARAMETER. Einer der Parameterwerte war ungültig.
Hinweise
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 |
| Header |
|
| DLL |
|
Siehe auch