EnumUILanguagesA-Funktion (winnls.h)

Artikel
11/20/2024

Listet die Benutzeroberflächensprachen auf, die im Betriebssystem verfügbar sind, und ruft die Rückruffunktion mit jeder Sprache in der Liste auf.

Syntax

BOOL EnumUILanguagesA(
  [in] UILANGUAGE_ENUMPROCA lpUILanguageEnumProc,
  [in] DWORD                dwFlags,
  [in] LONG_PTR             lParam
);

Parameter

[in] lpUILanguageEnumProc

Zeiger auf eine anwendungsdefinierte EnumUILanguagesProc Rückruffunktion. EnumUILanguages diese Funktion wiederholt aufruft, um die Sprachen in der Liste aufzählen zu können.

[in] dwFlags

Kennzeichnungen zur Identifizierung des Sprachformats und der Filterung. Die folgenden Flags geben das Format der Sprache an, die an die Rückruffunktion übergeben werden soll. Die Formatkennzeichnungen schließen sich gegenseitig aus, und MUI_LANGUAGE_ID ist die Standardeinstellung.

Wert	Bedeutung
MUI_LANGUAGE_ID	Übergeben Sie den Sprachbezeichner in der Sprachzeichenfolge an die Rückruffunktion.
MUI_LANGUAGE_NAME	Übergeben Sie den Sprachnamen in der Sprachzeichenfolge an die Rückruffunktion.

Die folgenden Flags geben die Filterung für die Funktion an, die beim Aufzählen der Sprachen verwendet werden soll. Die Filterkennzeichnungen schließen sich gegenseitig aus, und der Standardwert ist MUI_LICENSED_LANGUAGES.

Wert	Bedeutung
MUI_ALL_INSTALLED_LANGUAGES	Aufzählen aller installierten Sprachen, die für das Betriebssystem verfügbar sind.
MUI_LICENSED_LANGUAGES	Auflisten aller installierten Sprachen, die zur Verwendung verfügbar und lizenziert sind.
MUI_GROUP_POLICY	Aufzählen aller installierten Sprachen, die verfügbar und lizenziert sind, und die von die Gruppenrichtlinie.

Windows Vista und höher: Die Anwendung kann dwFlags auf 0 oder auf eine oder mehrere der angegebenen Flags festlegen. Eine Einstellung von 0 bewirkt, dass der Parameterwert standardmäßig MUI_LANGUAGE_ID | MUI_LICENSED_LANGUAGES.

Windows 2000, Windows XP, Windows Server 2003: Die Anwendung muss dwFlags- auf 0 festlegen.

[in] lParam

Anwendungsdefinierter Wert.

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_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
ERROR_INVALID_PARAMETER. Ungültige Parameterwerte.

Bemerkungen

Diese Funktion listet die verfügbaren Benutzeroberflächensprachen auf und zählt je nach angegebenem Flag die für die Verwendung auf dem Betriebssystem lizenzierten Sprachen auf. Sie übergibt Sprach-IDs oder Sprachnamen einzeln an die EnumUILanguagesProc Rückruffunktion. Die EnumUILanguages-Funktion übergibt weiterhin Sprachbezeichner oder Namen an die Rückruffunktion, bis die letzte Sprache gefunden wird, oder die Rückruffunktion gibt FALSE-zurück.

Für Anwendungen, die nur unter Windows Vista und höher ausgeführt werden, wird MUI_LANGUAGE_NAME über MUI_LANGUAGE_ID empfohlen. MUI_LANGUAGE_NAME ermöglicht die Differenzierung zwischen Sprachen, die einem ergänzenden Gebietsschemazugeordnet sind.

Wenn das flag MUI_LANGUAGE_ID im Aufruf dieser Funktion angegeben ist, werden die an den Rückruf übergebenen Zeichenfolgen

-Funktion ist hexadezimale Sprachbezeichner, die nicht die führende 0x enthalten, und 4

Zeichen in Länge. Beispielsweise wird en-US als "0409" und "en" als "0009" übergeben. Der Wert "1000" wird an die Rückruffunktion für jede Sprache übergeben, die einem ergänzenden Gebietsschema zugeordnet ist. Dieser Wert entspricht dem Hexadezimalwert von LOCALE_CUSTOM_UNSPECIFIED. Sie unterscheidet nicht zwischen ergänzenden Gebietsschemas, auch wenn sich die ausgewählte Sprache in der Liste der vom Benutzer bevorzugten Benutzeroberflächensprachen oder der Liste der vom System bevorzugten Benutzeroberflächensprachen befindet.

C#-Signatur

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.Boolean EnumUILanguages(
            EnumUILanguagesProc lpUILanguageEnumProc,
            System.UInt32 dwFlags,
            System.IntPtr lParam
            );

Anmerkung

Der winnls.h-Header definiert EnumUILanguages 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 [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	winnls.h (enthalten Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll