EnumLanguageGroupLocalesA-Funktion (winnls.h)

Artikel
08/27/2023

Listet die Gebietsschemas in einer angegebenen Sprachgruppe auf.

Hinweis Bei benutzerdefinierten Gebietsschemas sollte Ihre Anwendung EnumSystemLocalesEx vor EnumLanguageGroupLocales aufrufen.

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. Es kann auch verwendet werden, um die Threadsicherheit in der Rückruffunktion zu gewährleisten.

Rückgabewert

Gibt bei erfolgreicher Ausführung einen wert ungleichen Wert zurück, andernfalls 0. Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastError aufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

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

Hinweise

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

Hinweis

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winnls.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll