Fungsi GetProcessPreferredUILanguages (winnls.h)

Artikel
03/08/2023

Mengambil bahasa UI pilihan proses. Untuk informasi selengkapnya, lihat Manajemen Bahasa Antarmuka Pengguna.

Sintaks

BOOL GetProcessPreferredUILanguages(
  [in]            DWORD   dwFlags,
  [out]           PULONG  pulNumLanguages,
  [out, optional] PZZWSTR pwszLanguagesBuffer,
  [in, out]       PULONG  pcchLanguagesBuffer
);

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.

Nilai	Makna
MUI_LANGUAGE_ID	Ambil string bahasa dalam format pengidentifikasi bahasa .
MUI_LANGUAGE_NAME	Ambil string bahasa dalam format nama bahasa .

[out] pulNumLanguages

Arahkan ke jumlah bahasa yang diambil dalam pwszLanguagesBuffer.

[out, optional] pwszLanguagesBuffer

Opsional. Penunjuk ke buffer multi-string ganda yang dihentikan null di mana fungsi mengambil daftar yang diurutkan dan dibatasi null dalam urutan preferensi, dimulai dengan yang paling disukai.

Atau jika parameter ini diatur ke NULL dan pcchLanguagesBuffer diatur ke 0, fungsi mengambil ukuran buffer bahasa yang diperlukan di pcchLanguagesBuffer. Ukuran yang diperlukan mencakup dua karakter null.

[in, out] pcchLanguagesBuffer

Penunjuk ke ukuran, dalam karakter, untuk buffer bahasa yang ditunjukkan oleh pwszLanguagesBuffer. Saat pengembalian berhasil dari fungsi, parameter berisi ukuran buffer bahasa yang diambil.

Atau jika parameter ini diatur ke 0 dan pwszLanguagesBuffer diatur ke NULL, fungsi mengambil ukuran buffer bahasa yang diperlukan di pcchLanguagesBuffer.

Mengembalikan nilai

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

ERROR_INSUFFICIENT_BUFFER. Ukuran buffer yang disediakan tidak cukup besar, atau salah diatur ke NULL.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Jika daftar bahasa UI pilihan proses kosong atau jika bahasa yang ditentukan untuk proses tidak valid, fungsi berhasil dan mengembalikan multistring kosong di pwszLanguagesBuffer dan 2 dalam parameter pcchLanguagesBuffer .

Keterangan

Bergantung pada bendera yang ditentukan oleh aplikasi, fungsi ini dapat mengambil daftar yang terdiri dari bahasa UI pilihan proses. Jika menemukan bahasa duplikat, fungsi hanya mengambil instans pertama dari bahasa duplikat.

Ketika MUI_LANGUAGE_ID ditentukan, string bahasa yang diambil akan menjadi pengidentifikasi bahasa heksadesimal

yang tidak menyertakan 0x terkemuka, dan panjangnya akan menjadi 4 karakter. Misalnya, en-US akan dikembalikan

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 GetProcessPreferredUILanguages(
            System.UInt32 dwFlags,
            ref System.UInt32 pulNumLanguages,
            System.IntPtr pwszLanguagesBuffer,
            ref System.UInt32 pcchLanguagesBuffer
            );

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

Antarmuka Pengguna Multibahasa

Fungsi Antarmuka Pengguna Multibahasa

SetProcessPreferredUILanguages

Bagikan melalui