Fungsi SetProcessPreferredUILanguages (winnls.h)

Artikel
03/08/2023

Mengatur bahasa UI pilihan proses untuk proses aplikasi. Untuk informasi selengkapnya, lihat Manajemen Bahasa Antarmuka Pengguna.

Sintaks

BOOL SetProcessPreferredUILanguages(
  [in]            DWORD    dwFlags,
  [in, optional]  PCZZWSTR pwszLanguagesBuffer,
  [out, optional] PULONG   pulNumLanguages
);

Parameter

[in] dwFlags

Bendera yang mengidentifikasi format bahasa yang akan digunakan untuk proses bahasa UI pilihan. Bendera saling eksklusif, dan defaultnya adalah MUI_LANGUAGE_NAME.

Kami menyarankan agar Anda menggunakan MUI_LANGUAGE_NAME alih-alih MUI_LANGUAGE_ID.

Nilai	Makna
MUI_LANGUAGE_ID	String bahasa parameter input dalam format pengidentifikasi bahasa .
MUI_LANGUAGE_NAME	String bahasa parameter input dalam format nama bahasa .

[in, optional] pwszLanguagesBuffer

Penunjuk ke buffer multi-string ganda yang dihentikan null yang berisi daftar yang diurutkan dan dibatasi null dalam urutan preferensi yang menurun. Jika ada lebih dari lima bahasa dalam buffer, fungsi hanya mengatur lima bahasa pertama yang valid.

Atau, parameter ini dapat berisi NULL jika tidak ada daftar bahasa yang diperlukan. Dalam hal ini, fungsi menghapus bahasa UI pilihan untuk proses tersebut.

[out, optional] pulNumLanguages

Arahkan ke jumlah bahasa yang telah diatur dalam daftar bahasa proses dari buffer input, hingga maksimum lima.

Nilai kembali

Mengembalikan TRUE jika berhasil atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError, yang dapat mengembalikan kode kesalahan berikut:

ERROR_INVALID_PARAMETER. Parameter yang tidak valid ditentukan.

Jika daftar bahasa UI pilihan proses kosong atau jika bahasa yang ditentukan untuk proses tidak valid, fungsi berhasil dan mengatur 0 dalam parameter pulNumLanguages .

Keterangan

Idealnya, aplikasi akan memanggil SetProcessPreferredUILanguages sesegera mungkin setelah diluncurkan.

Setelah fungsi ini kembali, aplikasi dapat memanggil GetProcessPreferredUILanguages untuk memverifikasi dan memeriksa daftar bahasa yang dihasilkan.

Ketika MUI_LANGUAGE_ID ditentukan, string bahasa parameter input harus menggunakan bahasa heksadesimal

pengidentifikasi yang tidak menyertakan 0x di depannya, dan panjangnya 4 karakter. Misalnya, en-US harus

diteruskan sebagai "0409" dan en sebagai "0009".

Catatan Penggunaan MUI_LANGUAGE_NAME direkomendasikan melalui MUI_LANGUAGE_ID.

Tanda Tangan C#

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.Boolean SetProcessPreferredUILanguages(
            System.UInt32 dwFlags,
            System.String pwszLanguagesBuffer,
            ref System.UInt32 pulNumLanguages
            );

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetProcessPreferredUILanguages

Antarmuka Pengguna Multibahasa

Fungsi Antarmuka Pengguna Multibahasa

Bagikan melalui