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.

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

Windows Vista und höher: Die folgenden benutzerdefinierten Gebietsschema-IDs werden ebenfalls unterstützt.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

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.

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

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	Nlsdl.h
DLL	NlsMap.dll

Siehe auch

Unterstützung der Landessprache

Funktionen zur Unterstützung der Landessprache

Zuordnen von Gebietsschemadaten

GetLocaleInfo