EnumSystemLocalesEx-Funktion (winnls.h)

  • Artikel

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

Hinweis Die Anwendung sollte diese Funktion vor EnumSystemLocales aufrufen, wenn sie nur unter Windows Vista und höher ausgeführt werden soll.
 

Syntax

BOOL EnumSystemLocalesEx(
  [in]           LOCALE_ENUMPROCEX lpLocaleEnumProcEx,
  [in]           DWORD             dwFlags,
  [in]           LPARAM            lParam,
  [in, optional] LPVOID            lpReserved
);

Parameter

[in] lpLocaleEnumProcEx

Zeiger auf eine anwendungsdefinierte Rückruffunktion. Die EnumSystemLocalesEx-Funktion listet Gebietsschemas auf, indem diese Rückruffunktion wiederholt aufgerufen wird. Weitere Informationen finden Sie unter EnumLocalesProcEx.

[in] dwFlags

Flags, die die zu aufzählenden Gebietsschemas identifizieren. Die Flags können mit einem binären ODER kombiniert oder verwendet werden. Wenn die Anwendung 0 für diesen Parameter angibt, verhält sich die Funktion wie für LOCALE_ALL.

[in] lParam

Ein von der Anwendung bereitgestellter Parameter, der an die Rückruffunktion übergeben werden soll. Dies ist besonders nützlich für Multithreadanwendungen.

[in, optional] lpReserved

Reserviert; muss NULL sein.

Rückgabewert

Gibt bei erfolgreicher Ausführung einen wert ungleichen Wert zurück, andernfalls 0. 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 Gebietsschemas auf, indem Gebietsschemanamen einzeln an die anwendungsdefinierte Rückruffunktion übergeben werden, die von lpLocaleEnumProcEx angegeben wird. Die Enumeration wird fortgesetzt, bis alle installierten oder unterstützten Namen an die Rückruffunktion übergeben wurden oder die Rückruffunktion FALSE zurückgibt.

Die Optionen für den dwFlags-Parameter unterscheiden sich von denen für EnumSystemLocales, die zwischen installierten und unterstützten Gebietsschemas unterscheiden müssen.

Wenn dwFlagsLOCALE_ALTERNATE_SORTS angibt, wird die Rückruffunktion für jedes Gebietsschema aufgerufen, das eine alternative Sortierreihenfolge darstellt. Beispielsweise ist Spanisch (Spanien) standardmäßig auf internationale Sortierreihenfolge festgelegt, aber die herkömmliche Sortierreihenfolge ist für eine alternative Sortierung verfügbar. Deutsch (Deutschland) ist standardmäßig Wörterbuchsortierreihenfolge, aber es ist eine alternative Telefonbuchsortierreihenfolge verfügbar.

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter NLS: Beispiel für namenbasierte APIs.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winnls.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

EnumLocalesProcEx

EnumSystemLocales

Unterstützung für nationale Sprachen

Nationale Sprachunterstützungsfunktionen