DownlevelGetParentLocaleName-Funktion

Ruft den Gebietsschemanamen für das übergeordnete Gebietsschema des angegebenen Gebietsschemas ab.

Hinweis

Diese Funktion wird nur von Anwendungen verwendet, die auf vorab Windows Vista-Betriebssystemen ausgeführt werden. Die Verwendung erfordert das Downloadpaket. Anwendungen, die nur auf Windows Vista ausgeführt werden, und höher sollten GetLocaleInfo mit LCType aufrufen, die auf LOCALE_SPARENT festgelegt sind.

 

Syntax

int DownlevelGetParentLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName
);

Parameter

Gebietsschema [in]

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

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

lpName [out]

Zeiger auf einen Puffer, in dem die Funktion den übergeordneten Gebietsschemanamen oder einen der folgenden vordefinierten Werte abruft. Dieser Parameter wird auf NULL festgelegt, wenn cchName auf 0 festgelegt ist.

cchName [in]

Größe des Puffers, der durch lpName angegeben ist, in UTF-16-Codepunkten. Ein Wert von 0 für diesen Parameter bewirkt, dass die Funktion den lpName-Puffer ignoriert und die Größe des Puffers in Zeichen (einschließlich null Zeichen) zurückgibt, die erforderlich sind, um den übergeordneten Gebietsschemanamen zu enthalten.

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 ist. Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastError aufrufen, wodurch eine der folgenden Fehlercodes zurückgegeben werden kann:

  • ERROR_INSUFFICIENT_BUFFER. Eine angegebene Puffergröße war nicht groß genug, oder sie wurde falsch auf NULL festgelegt.
  • ERROR_INVALID_PARAMETER. Eine der Parameterwerte war ungültig.

Bemerkungen

Die erforderliche Headerdatei und DLL sind Teil des Downloads "Microsoft NLS Downlevel Data Mapping APIs", der im Microsoft Download Center verfügbar ist.

Requirements (Anforderungen)

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

Weitere Informationen

Unterstützung für nationale Sprachen

Unterstützungsfunktionen für nationale Sprachen

Zuordnung von Gebietsschemadaten

GetLocaleInfo