EnumSystemLocalesA-Funktion (winnls.h)

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

Hinweis Aus Interoperabilitätsgründen sollte die Anwendung die EnumSystemLocalesEx-Funktion gegenüber EnumSystemLocales vorziehen, da Microsoft zur Verwendung von Gebietsschemanamen anstelle von Gebietsschemabezeichnern für neue Gebietsschemas migriert. Jede Anwendung, die nur unter Windows Vista und höher ausgeführt wird, sollte EnumSystemLocalesEx verwenden.

 

Syntax

BOOL EnumSystemLocalesA(
  [in] LOCALE_ENUMPROCA lpLocaleEnumProc,
  [in] DWORD            dwFlags
);

Parameter

[in] lpLocaleEnumProc

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

[in] dwFlags

Flags, die die zu enumerierenden Gebietsschemabezeichner angeben. Die Flags können mit einem binären ODER kombiniert oder verwendet werden. Wenn die Anwendung für diesen Parameter 0 angibt, verhält sich die Funktion wie für LCID_SUPPORTED.

Wert	Bedeutung
LCID_INSTALLED	Listet nur installierte Gebietsschemabezeichner auf. Dieser Wert kann nicht mit LCID_SUPPORTED verwendet werden.
LCID_SUPPORTED	Listet alle unterstützten Gebietsschemabezeichner auf. Dieser Wert kann nicht mit LCID_INSTALLED verwendet werden.
LCID_ALTERNATE_SORTS	Enumerieren Sie nur die alternativen Sortiergebietsbezeichner. Wenn dieser Wert mit LCID_INSTALLED oder LCID_SUPPORTED verwendet wird, werden die installierten oder unterstützten Gebietsschemas sowie die alternativen Sortiergebietsbezeichner abgerufen.

Rückgabewert

Gibt bei erfolgreicher Ausführung einen Wert ungleich 0 zurück, andernfalls 0. 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

Die Funktion listet Gebietsschemas auf, indem gebietsschemabezeichner einzeln an die angegebene anwendungsdefinierte Rückruffunktion übergeben werden. Dies wird fortgesetzt, bis alle installierten oder unterstützten Gebietsschemabezeichner an die Rückruffunktion übergeben wurden oder die Rückruffunktion FALSE zurückgibt.

Hinweis

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

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

Siehe auch

EnumLocalesProc

EnumSystemLocalesEx

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen