SetThreadLocale-Funktion (winnls.h)

  • Artikel

Legt das aktuelle Gebietsschema des aufrufenden Threads fest.

Syntax

BOOL SetThreadLocale(
  [in] LCID Locale
);

Parameter

[in] Locale

Gebietsschemabezeichner , der das Gebietsschema angibt. Sie können das MAKELCID-Makro verwenden, um einen Gebietsschemabezeichner zu erstellen oder einen der folgenden vordefinierten Werte zu verwenden.

Rückgabewert

Die Funktion sollte bei Erfolg eine LCID zurückgeben. Dies ist die LCID des vorherigen Threadgebietsschemas.

Hinweise

Wenn ein Thread erstellt wird, wird das Gebietsschema des Benutzers verwendet. Dieser Wert wird von GetUserDefaultLCID zurückgegeben. Das Benutzergebietsschema kann für zukünftige Prozesse und die Threaderstellung mithilfe der Regional- und Sprachoptionen des Systemsteuerung geändert werden. Das Threadgebietsschema kann auch mithilfe von SetThreadLocale geändert werden.

SetThreadLocale wirkt sich auf die Auswahl von Ressourcen mit einer LANGUAGE-Anweisung aus. Die Anweisung wirkt sich auf Funktionen wie CreateDialog, DialogBox, LoadMenu, LoadString und FindResource aus. Sie legt die Codepage fest, die von CP_THREAD_ACP impliziert wird, wirkt sich jedoch nicht auf FindResourceEx aus. Weitere Informationen finden Sie unter CodePage-Bezeichner.

Windows Vista und höher: Verwenden Sie setThreadLocale nicht, um eine Benutzeroberflächensprache auszuwählen. Das Ressourcenladeprogramm wählt die Ressource aus, die in der RC-Datei mit einer LANGUAGE-Anweisung definiert ist, oder die Anwendung kann FindResourceEx verwenden. Darüber hinaus kann die Anwendung SetThreadUILanguage verwenden.

Windows 2000, Windows XP: Verwenden Sie setThreadLocale nicht, um eine Benutzeroberflächensprache auszuwählen. Um die Ressource auszuwählen, die in der RC-Datei mit einer LANGUAGE-Anweisung definiert ist, muss die Anwendung die FindResourceEx-Funktion verwenden.

Anforderungen

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

Siehe auch

GetSystemDefaultLCID

GetThreadLocale

GetUserDefaultLCID

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen