EnumSystemLocalesA-Funktion (winnls.h)

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

Hinweis Aus Interoperabilitätsgründen sollte die Anwendung die funktion EnumSystemLocalesEx bevorzugen, um EnumSystemLocales zu , da Microsoft zur Verwendung von Gebietsschemanamen anstelle von Gebietsschema-IDs für neue Gebietsschemas migriert wird. Jede Anwendung, die nur unter Windows Vista und höher ausgeführt wird, sollte EnumSystemLocalesExverwenden.

 

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 Gebietsschema-IDs angeben, die aufgezählt werden sollen. Die Flags können mithilfe einer binären OR-Datei singly oder kombiniert werden. Wenn die Anwendung 0 für diesen Parameter angibt, verhält sich die Funktion wie für LCID_SUPPORTED.

Wert	Bedeutung
LCID_INSTALLED	Aufzählen nur installierter Gebietsschema-IDs. Dieser Wert kann nicht mit LCID_SUPPORTED verwendet werden.
LCID_SUPPORTED	Aufzählen aller unterstützten Gebietsschema-IDs. Dieser Wert kann nicht mit LCID_INSTALLED verwendet werden.
LCID_ALTERNATE_SORTS	Aufzählen Sie nur die alternativen Sortiergebietsschema-IDs. Wenn dieser Wert entweder mit LCID_INSTALLED oder LCID_SUPPORTED verwendet wird, werden die installierten oder unterstützten Gebietsschemas sowie die alternativen Sortiergebietsschema-IDs abgerufen.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn dies erfolgreich war, oder 0 andernfalls. 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

Die Funktion listet Gebietsschemas auf, indem Gebietsschema-IDs 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 gibt FALSEzurück.

Anmerkung

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

EnumLocalesProc

EnumSystemLocalesEx

Funktionen