Fungsi SetThreadUILanguage (winnls.h)

Artikel
03/08/2023

Mengatur bahasa antarmuka pengguna untuk utas saat ini.

Windows Vista dan yang lebih baru: Fungsi ini tidak dapat menghapus daftar bahasa UI pilihan utas. Aplikasi MUI Anda harus memanggil SetThreadPreferredUILanguages untuk menghapus daftar bahasa.

Windows XP: Fungsi ini terbatas untuk memungkinkan sistem operasi mengidentifikasi dan menetapkan nilai yang aman digunakan pada konsol Windows.

Sintaks

LANGID SetThreadUILanguage(
  [in] LANGID LangId
);

Parameter

[in] LangId

Pengidentifikasi bahasa untuk bahasa antarmuka pengguna untuk utas.

Windows Vista dan yang lebih baru: Aplikasi dapat menentukan pengidentifikasi bahasa 0 atau pengidentifikasi bukan nol. Untuk informasi lebih lanjut, lihat bagian Keterangan.

Windows XP: Aplikasi hanya dapat mengatur parameter ini ke 0. Pengaturan ini menyebabkan fungsi memilih bahasa yang paling mendukung tampilan konsol. Untuk informasi lebih lanjut, lihat bagian Keterangan.

Mengembalikan nilai

Mengembalikan pengidentifikasi bahasa input jika berhasil. Jika pengidentifikasi input bukan nol, fungsi mengembalikan nilai tersebut. Jika pengidentifikasi bahasa adalah 0, fungsi selalu berhasil dan mengembalikan pengidentifikasi bahasa yang paling mendukung konsol Windows. Lihat bagian Keterangan.

Jika pengidentifikasi bahasa input bukan nol dan fungsi gagal, nilai yang dikembalikan berbeda dari pengidentifikasi bahasa input. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError.

Keterangan

Saat utas dibuat, pengaturan bahasa antarmuka pengguna utas kosong dan antarmuka pengguna untuk utas ditampilkan dalam bahasa yang dipilih pengguna. Fungsi ini memungkinkan aplikasi untuk mengubah bahasa antarmuka pengguna untuk utas yang sedang berjalan saat ini.

Windows Vista dan yang lebih baru: Memanggil fungsi ini dan menentukan 0 untuk pengidentifikasi bahasa identik dengan memanggil SetThreadPreferredUILanguages dengan set bendera MUI_CONSOLE_FILTER. Jika aplikasi menentukan pengidentifikasi bahasa bukan nol yang valid, fungsi menetapkan bahasa antarmuka pengguna tertentu untuk utas. Setelah menentukan 0 untuk pengidentifikasi bahasa, aplikasi tidak dapat menggunakan salah satu konstanta berikut untuk sesuai dengan pengidentifikasi bahasa:

Windows XP: Ketika aplikasi memanggil fungsi ini dengan pengidentifikasi bahasa 0, fungsi pertama-tama memverifikasi bahwa antarmuka pengguna saat ini tidak memerlukan Uniscribe, dan bahwa itu didukung oleh halaman kode konsol. Jika antarmuka pengguna lulus pengujian ini, fungsi menggunakan nilai yang disediakan. Jika tidak, fungsi mengubah bahasa antarmuka pengguna utas menjadi bahasa yang dapat ditampilkan konsol Windows. Windows XP tidak mendukung konsep bahasa antarmuka pengguna utas yang terpisah dari lokal utas. Oleh karena itu, fungsi ini mengubah lokal utas pada Windows XP. Mudah bagi aplikasi Anda untuk mengatur utas untuk menggunakan bahasa yang paling tepat untuk tampilan konsol, berdasarkan bahasa UI pilihan pengguna dan sistem, bahasa untuk aplikasi non-Unicode, dan kemampuan konsol.

Tanda Tangan C#

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll