DownlevelGetParentLocaleName-Funktion

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

Hinweis

Diese Funktion wird nur von Anwendungen verwendet, die unter Betriebssystemen vor Windows Vista ausgeführt werden. Die Verwendung erfordert das Downloadpaket. Anwendungen, die nur auf Windows Vista und höher ausgeführt werden, sollten GetLocaleInfo aufrufen, wobei LCType auf LOCALE _ SPARENTfestgelegt ist.

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 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 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 Puffers, der durch lpName in UTF-16-Codepunkten angegeben wird. Der Wert 0 für diesen Parameter bewirkt, dass die Funktion den lpName-Puffer ignoriert und die Größe des Puffers in Zeichen (enthaltene NULL-Zeichen) zurückgibt, die für den Namen des übergeordneten Gebietsschemas erforderlich sind.

Rückgabewert

Gibt bei Erfolg die Anzahl der UTF-16-Codepunkte im Gebietsschemanamen zurück, einschließlich des abschließenden NULL-Zeichens.

Diese Funktion gibt 0 zurück, wenn sie nicht erfolgreich ist. Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastErroraufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

  • FEHLER: _ _ UNZUREICHENDER PUFFER. Eine angegebene Puffergröße war nicht groß genug, oder sie wurde fälschlicherweise auf NULL festgelegt.
  • FEHLER: _ UNGÜLTIGER _ PARAMETER. Jeder der Parameterwerte war ungültig.

Hinweise

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

Anforderungen

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

Siehe auch

Unterstützung für nationale Sprachen

Unterstützungsfunktionen für nationale Sprachen

Zuordnen von Gebietsschemadaten

GetLocaleInfo