EnumSystemLanguageGroupsW-Funktion (winnls.h)

Artikel
11/20/2024

Listet die Sprachgruppen auf, die entweder auf einem Betriebssystem installiert oder unterstützt werden.

Hinweis Für benutzerdefinierte Gebietsschemas sollte Ihre Anwendung EnumSystemLocalesEx- anstelle von EnumSystemLanguageGroupsaufrufen.

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 aufzählenden Sprachgruppenbezeichner angeben. Dieser Parameter kann einen der folgenden Werte aufweisen.

Wert	Bedeutung
LGRPID_INSTALLED	Aufzählen nur installierter Sprachgruppen-IDs.
LGRPID_SUPPORTED	Aufzählen aller unterstützten Sprachgruppen-IDs.

[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 sicherzustellen.

Rückgabewert

Gibt TRUE zurück, wenn die erfolgreich oder falsch ist. 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 Sprachgruppen auf, indem Sprachgruppen-IDs einzeln an die angegebene anwendungsdefinierte Rückruffunktion übergeben werden. Dieser Vorgang wird fortgesetzt, bis der letzte Sprachgruppenbezeichner gefunden wird, oder die Rückruffunktion gibt FALSEzurück.

Anmerkung

Der winnls.h-Header definiert EnumSystemLanguageGroups 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

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

Funktionen

Freigeben über