EnumSystemLanguageGroupsW-Funktion (winnls.h)

Artikel
08/27/2023

Listet die Sprachgruppen auf, die entweder unter einem Betriebssystem installiert sind oder von diesem unterstützt werden.

Hinweis Für benutzerdefinierte Gebietsschemas sollte Ihre Anwendung EnumSystemLocalesEx anstelle von EnumSystemLanguageGroups aufrufen.

Syntax

BOOL EnumSystemLanguageGroupsW(
  [in] LANGUAGEGROUP_ENUMPROCW lpLanguageGroupEnumProc,
  [in] DWORD                   dwFlags,
  [in] LONG_PTR                lParam
);

Parameter

[in] lpLanguageGroupEnumProc

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

[in] dwFlags

Flags, die die zu enumerierenden Sprachgruppenbezeichner angeben. Dieser Parameter kann einen der folgenden Werte aufweisen.

Wert	Bedeutung
LGRPID_INSTALLED	Listet nur installierte Sprachgruppenbezeichner auf.
LGRPID_SUPPORTED	Auflisten aller unterstützten Sprachgruppenbezeichner.

[in] lParam

Anwendungsdefinierter Wert, der an die Rückruffunktion übergeben werden soll. Dieser Parameter kann bei der Fehlerüberprüfung verwendet werden. Sie kann auch verwendet werden, um die Threadsicherheit in der Rückruffunktion zu gewährleisten.

Rückgabewert

Gibt TRUE zurück, wenn dies erfolgreich war, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, 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 Sprachgruppen auf, indem sprachgruppenspezifische Bezeichner einzeln an die angegebene anwendungsdefinierte Rückruffunktion übergeben werden. Dieser Prozess wird fortgesetzt, bis der letzte Sprachgruppenbezeichner gefunden wird oder die Rückruffunktion FALSE zurückgibt.

Hinweis

Der winnls.h-Header definiert EnumSystemLanguageGroups 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 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
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 (windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll