Fungsi EnumSystemLanguageGroupsA (winnls.h)

Artikel
08/27/2023

Menghitung grup bahasa yang diinstal atau didukung oleh sistem operasi.

Catatan Untuk lokal kustom, aplikasi Anda harus memanggil EnumSystemLocalesEx alih-alih EnumSystemLanguageGroups.

Sintaks

BOOL EnumSystemLanguageGroupsA(
  [in] LANGUAGEGROUP_ENUMPROCA lpLanguageGroupEnumProc,
  [in] DWORD                   dwFlags,
  [in] LONG_PTR                lParam
);

Parameter

[in] lpLanguageGroupEnumProc

Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi. Untuk informasi selengkapnya, lihat EnumLanguageGroupsProc.

[in] dwFlags

Bendera yang menentukan pengidentifikasi grup bahasa yang akan dijumlahkan. Parameter ini dapat memiliki salah satu nilai berikut.

Nilai	Makna
LGRPID_INSTALLED	Hitung hanya pengidentifikasi grup bahasa yang terinstal.
LGRPID_SUPPORTED	Hitung semua pengidentifikasi grup bahasa yang didukung.

[in] lParam

Nilai yang ditentukan aplikasi untuk diteruskan ke fungsi panggilan balik. Parameter ini dapat digunakan dalam pemeriksaan kesalahan. Ini juga dapat digunakan untuk memastikan keamanan utas dalam fungsi panggilan balik.

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_BADDB. Fungsi tidak dapat mengakses data. Situasi ini biasanya tidak boleh terjadi, dan biasanya menunjukkan penginstalan yang buruk, masalah disk, atau sejenisnya.
ERROR_INVALID_FLAGS. Nilai yang diberikan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Fungsi ini menghitung grup bahasa dengan meneruskan pengidentifikasi grup bahasa, satu per satu, ke fungsi panggilan balik yang ditentukan aplikasi yang ditentukan. Proses ini berlanjut hingga pengidentifikasi grup bahasa terakhir ditemukan atau fungsi panggilan balik mengembalikan FALSE.

Catatan

Header winnls.h mendefinisikan EnumSystemLanguageGroups 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 [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll