EnumSystemLanguageGroupsA-Funktion (winnls.h)

  • Artikel

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

Hinweis Bei benutzerdefinierten Gebietsschemas sollte Ihre Anwendung EnumSystemLocalesEx anstelle von EnumSystemLanguageGroups aufrufen.

 

Syntax

BOOL EnumSystemLanguageGroupsA(
  [in] LANGUAGEGROUP_ENUMPROCA 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
 Enumerieren Sie nur installierte Sprachgruppenbezeichner.
LGRPID_SUPPORTED
 Listet alle unterstützten Sprachgruppenbezeichner auf.

[in] lParam

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

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . 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 Sprachgruppen auf, indem Sprachgruppenbezeichner 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 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

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 (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

Unterstützung für nationale Sprachen

Nationale Sprachunterstützungsfunktionen