Fungsi EnumUILanguagesA (winnls.h)

Artikel
08/27/2023

Menghitung bahasa antarmuka pengguna yang tersedia pada sistem operasi dan memanggil fungsi panggilan balik dengan setiap bahasa dalam daftar.

Sintaks

BOOL EnumUILanguagesA(
  [in] UILANGUAGE_ENUMPROCA lpUILanguageEnumProc,
  [in] DWORD                dwFlags,
  [in] LONG_PTR             lParam
);

Parameter

[in] lpUILanguageEnumProc

Arahkan ke fungsi panggilan balik EnumUILanguagesProc yang ditentukan aplikasi. EnumUILanguages memanggil fungsi ini berulang kali untuk menghitung bahasa dalam daftar.

[in] dwFlags

Bendera yang mengidentifikasi format dan pemfilteran bahasa. Bendera berikut menentukan format bahasa yang akan diteruskan ke fungsi panggilan balik. Bendera format saling eksklusif, dan MUI_LANGUAGE_ID adalah default.

Nilai	Makna
MUI_LANGUAGE_ID	Teruskan pengidentifikasi bahasa dalam string bahasa ke fungsi panggilan balik.
MUI_LANGUAGE_NAME	Teruskan nama bahasa dalam string bahasa ke fungsi panggilan balik.

Bendera berikut menentukan pemfilteran untuk fungsi yang akan digunakan dalam menghitung bahasa. Bendera pemfilteran saling eksklusif, dan defaultnya adalah MUI_LICENSED_LANGUAGES.

Nilai	Makna
MUI_ALL_INSTALLED_LANGUAGES	Menghitung semua bahasa yang terinstal yang tersedia untuk sistem operasi.
MUI_LICENSED_LANGUAGES	Hitung semua bahasa terinstal yang tersedia dan berlisensi untuk digunakan.
MUI_GROUP_POLICY	Menghitung semua bahasa yang terinstal yang tersedia dan berlisensi, dan yang diizinkan oleh kebijakan grup.

Windows Vista dan yang lebih baru: Aplikasi dapat mengatur dwFlags ke 0, atau ke satu atau beberapa bendera yang ditentukan. Pengaturan 0 menyebabkan nilai parameter default ke MUI_LANGUAGE_ID | MUI_LICENSED_LANGUAGES.

Windows 2000, Windows XP, Windows Server 2003: Aplikasi harus mengatur dwFlags ke 0.

[in] lParam

Nilai yang ditentukan aplikasi.

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_INVALID_FLAGS. Nilai yang disediakan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Fungsi ini menghitung bahasa antarmuka pengguna yang tersedia dan, tergantung pada bendera yang ditentukan, dilisensikan untuk digunakan pada sistem operasi. Ini meneruskan pengidentifikasi bahasa atau nama bahasa, satu per satu, ke fungsi panggilan balik EnumUILanguagesProc . Fungsi EnumUILanguages terus meneruskan pengidentifikasi bahasa atau nama ke fungsi panggilan balik hingga bahasa terakhir ditemukan atau fungsi panggilan balik mengembalikan FALSE.

Untuk aplikasi yang hanya berjalan pada Windows Vista dan yang lebih baru, MUI_LANGUAGE_NAME direkomendasikan melalui MUI_LANGUAGE_ID. MUI_LANGUAGE_NAME memungkinkan diferensiasi antara bahasa yang terkait dengan lokal tambahan.

Jika bendera MUI_LANGUAGE_ID ditentukan dalam panggilan ke fungsi ini, string diteruskan ke panggilan balik

fungsi akan menjadi pengidentifikasi bahasa heksadesimal yang tidak menyertakan 0x terkemuka, dan akan menjadi 4

panjang karakter. Misalnya, en-US akan diteruskan sebagai "0409" dan en sebagai "0009". Nilai "1000" diteruskan ke fungsi panggilan balik untuk bahasa apa pun yang terkait dengan lokal tambahan. Nilai ini sesuai dengan nilai heksadesimal LOCALE_CUSTOM_UNSPECIFIED. Ini tidak membedakan di antara lokal tambahan, bahkan jika bahasa yang dipilih ada dalam daftar bahasa UI pilihan pengguna atau daftar bahasa UI pilihan sistem.

Tanda Tangan C#

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.Boolean EnumUILanguages(
            EnumUILanguagesProc lpUILanguageEnumProc,
            System.UInt32 dwFlags,
            System.IntPtr lParam
            );

Catatan

Header winnls.h mendefinisikan EnumUILanguages sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll