SetThreadUILanguage-Funktion (winnls.h)

  • Artikel

Legt die Sprache der Benutzeroberfläche für den aktuellen Thread fest.

Windows Vista und höher: Diese Funktion kann die Liste der bevorzugten Benutzeroberflächensprachen des Threads nicht löschen. Ihre MUI-Anwendung sollte SetThreadPreferredUILanguages aufrufen, um die Sprachliste zu löschen.

Windows XP: Diese Funktion ist darauf beschränkt, dem Betriebssystem zu ermöglichen, einen Wert zu identifizieren und festzulegen, der sicher in der Windows-Konsole verwendet werden kann.

Syntax

LANGID SetThreadUILanguage(
  [in] LANGID LangId
);

Parameter

[in] LangId

Sprachbezeichner für die Sprache der Benutzeroberfläche für den Thread.

Windows Vista und höher: Die Anwendung kann einen Sprachbezeichner von 0 oder einen Bezeichner ungleich Null angeben. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Windows XP: Die Anwendung kann diesen Parameter nur auf 0 festlegen. Diese Einstellung bewirkt, dass die Funktion die Sprache auswählt, die die Konsolenanzeige am besten unterstützt. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Rückgabewert

Gibt bei erfolgreicher Ausführung den Eingabesprachbezeichner zurück. Wenn der Eingabebezeichner ungleich null ist, gibt die Funktion diesen Wert zurück. Wenn der Sprachbezeichner 0 ist, ist die Funktion immer erfolgreich und gibt den Bezeichner der Sprache zurück, die die Windows-Konsole am besten unterstützt. Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.

Wenn der Eingabesprachbezeichner ungleich null ist und die Funktion fehlschlägt, unterscheidet sich der Rückgabewert vom Eingabesprachbezeichner. Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastError aufrufen.

Hinweise

Wenn ein Thread erstellt wird, ist die Spracheinstellung für die Thread-Benutzeroberfläche leer, und die Benutzeroberfläche für den Thread wird in der vom Benutzer ausgewählten Sprache angezeigt. Mit dieser Funktion kann die Anwendung die Sprache der Benutzeroberfläche für den aktuell ausgeführten Thread ändern.

Windows Vista und höher: Das Aufrufen dieser Funktion und die Angabe von 0 für den Sprachbezeichner ist identisch mit dem Aufruf von SetThreadPreferredUILanguages mit festgelegtem MUI_CONSOLE_FILTER Flag. Wenn die Anwendung einen gültigen Sprachbezeichner ungleich 0 (null) angibt, legt die Funktion eine bestimmte Benutzeroberflächensprache für den Thread fest. Nach dem Angeben von 0 für den Sprachbezeichner kann die Anwendung keine der folgenden Konstanten verwenden, um einem Sprachbezeichner zu entsprechen:

Windows XP: Wenn die Anwendung diese Funktion mit dem Sprachbezeichner 0 aufruft, überprüft die Funktion zunächst, ob die aktuelle Benutzeroberfläche Uniscribe nicht erfordert und von der Konsolencodepage unterstützt wird. Wenn die Benutzeroberfläche diese Tests besteht, verwendet die Funktion den angegebenen Wert. Andernfalls ändert die Funktion die Sprache der Thread-Benutzeroberfläche in eine Sprache, die von der Windows-Konsole angezeigt werden kann. Windows XP unterstützt kein Konzept der Threadbenutzeroberflächensprache, die vom Threadgebietsschema getrennt ist. Daher ändert diese Funktion das Threadgebietsschema unter Windows XP. Es ist für Ihre Anwendung einfach, einen Thread so festzulegen, dass er die am besten geeignete Sprache für die Konsolenanzeige verwendet, basierend auf benutzer- und systemspezifischen Benutzeroberflächensprachen, der Sprache für Nicht-Unicode-Anwendungen und den Funktionen der Konsole.

C#-Signatur

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.UInt16 SetThreadUILanguage(
            System.UInt16 LangId
            );

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winnls.h (windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GetThreadUILanguage

Multilingual User Interface

Mehrsprachige Benutzeroberflächenfunktionen

SetThreadPreferredUILanguages