SetThreadLocale-Funktion (winnls.h)
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.
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
- LOCALE_INVARIANT
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
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 |