EnumLanguageGroupLocalesA-Funktion (winnls.h)

Artikel
11/20/2024

Listet die Gebietsschemas in einer angegebenen Sprachgruppe auf.

Hinweis Bei benutzerdefinierten Gebietsschemas sollte Ihre Anwendung EnumSystemLocalesEx- vor dem EnumLanguageGroupLocalesaufrufen.

Syntax

BOOL EnumLanguageGroupLocalesA(
  [in] LANGGROUPLOCALE_ENUMPROCA lpLangGroupLocaleEnumProc,
  [in] LGRPID                    LanguageGroup,
  [in] DWORD                     dwFlags,
  [in] LONG_PTR                  lParam
);

Parameter

[in] lpLangGroupLocaleEnumProc

Zeiger auf eine anwendungsdefinierte Rückruffunktion. Weitere Informationen finden Sie unter EnumLanguageGroupLocalesProc.

[in] LanguageGroup

Bezeichner der Sprachgruppe, für die Gebietsschemas aufgelistet werden sollen. Dieser Parameter kann einen der folgenden Werte aufweisen:

LGRPID_ARABIC
LGRPID_ARMENIAN
LGRPID_BALTIC
LGRPID_CENTRAL_EUROPE
LGRPID_CYRILLIC
LGRPID_GEORGIAN
LGRPID_GREEK
LGRPID_HEBREW
LGRPID_INDIC
LGRPID_JAPANESE
LGRPID_KOREAN
LGRPID_SIMPLIFIED_CHINESE
LGRPID_TRADITIONAL_CHINESE
LGRPID_THAI
LGRPID_TURKIC
LGRPID_TURKISH
LGRPID_VIETNAMESE
LGRPID_WESTERN_EUROPE

[in] dwFlags

Reserviert; muss 0 sein.

[in] lParam

Ein anwendungsdefinierter Wert, der an die Rückruffunktion übergeben werden soll. Dieser Wert kann für die Fehlerüberprüfung verwendet werden. Sie kann auch verwendet werden, um die Threadsicherheit in der Rückruffunktion sicherzustellen.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn dies erfolgreich war, oder 0 andernfalls. Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastErroraufrufen, wodurch eine der folgenden Fehlercodes zurückgegeben werden kann:

ERROR_BADDB. Die Funktion konnte nicht auf die Daten zugreifen. Diese Situation sollte normalerweise nicht auftreten und zeigt in der Regel eine fehlerhafte Installation, ein Datenträgerproblem oder ähnliches an.
ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
ERROR_INVALID_PARAMETER. Ungültige Parameterwerte.

Bemerkungen

Diese Funktion listet Gebietsschemas in der angegebenen Sprachgruppe auf, indem Gebietsschema-IDs einzeln an die anwendungsdefinierte Rückruffunktion übergeben werden. Dieser Vorgang wird fortgesetzt, bis EnumLanguageGroupLocales den letzten Gebietsschemabezeichner findet, oder die Rückruffunktion gibt FALSE-zurück.

Anmerkung

Der winnls.h-Header definiert EnumLanguageGroupLocales als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winnls.h (enthalten Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll

Siehe auch

EnumLanguageGroupLocalesProc

EnumSystemLanguageGroups

EnumSystemLocalesEx

IsValidLanguageGroup

Funktionen

Freigeben über