EnumUILanguagesA-Funktion (winnls.h)

Artikel
03/04/2024

Listet die Sprachen der Benutzeroberfläche auf, die auf dem 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 ruft diese Funktion wiederholt auf, um die Sprachen in der Liste aufzulisten.

[in] dwFlags

Flags 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 Formatflags 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 Filterflags schließen sich gegenseitig aus, und der Standardwert ist MUI_LICENSED_LANGUAGES.

Wert	Bedeutung
MUI_ALL_INSTALLED_LANGUAGES	Listet alle installierten Sprachen auf, die für das Betriebssystem verfügbar sind.
MUI_LICENSED_LANGUAGES	Listet alle installierten Sprachen auf, die verfügbar und für die Verwendung lizenziert sind.
MUI_GROUP_POLICY	Auflisten aller installierten Sprachen, die verfügbar und lizenziert sind und von zugelassen sind die Gruppenrichtlinie.

Windows Vista und höher: Die Anwendung kann dwFlags auf 0 oder auf ein oder mehrere der angegebenen Flags festlegen. Die Einstellung 0 bewirkt, dass der Parameterwert standardmäßig auf 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 dies erfolgreich war, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastError aufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

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 die verfügbaren Benutzeroberflächensprachen auf und ist abhängig vom angegebenen Flag für die Verwendung auf dem Betriebssystem lizenziert. Sprachbezeichner oder Sprachnamen werden einzeln an die Rückruffunktion EnumUILanguagesProc übergeben. Die EnumUILanguages-Funktion übergibt weiterhin Sprachbezeichner oder Namen an die Rückruffunktion, bis die letzte Sprache gefunden wird oder die Rückruffunktion FALSE zurückgibt.

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 Unterscheidung zwischen Sprachen, die einem zusätzlichen Gebietsschema zugeordnet sind.

Wenn das MUI_LANGUAGE_ID-Flag im Aufruf dieser Funktion angegeben wird, werden die an den Rückruf übergebenen Zeichenfolgen

-Funktion ist hexadezimale Sprachbezeichner, die nicht den führenden 0x enthalten, und ist 4.

Zeichen in der 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 zusätzlichen Gebietsschema zugeordnet ist. Dieser Wert entspricht dem Hexadezimalwert von LOCALE_CUSTOM_UNSPECIFIED. Es unterscheidet nicht zwischen zusätzlichen Gebietsschemas, auch wenn die ausgewählte Sprache in der Liste der bevorzugten Benutzeroberflächensprachen oder in der Liste der bevorzugten Benutzeroberflächensprachen des Systems enthalten ist.

C#-Signatur

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

Hinweis

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winnls.h (windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll