Fungsi EnumSystemLocalesEx (winnls.h)

  • Artikel

Menghitung lokal yang diinstal atau didukung oleh sistem operasi.

Catatan Aplikasi harus memanggil fungsi ini disukai enumSystemLocales jika dirancang untuk berjalan hanya pada Windows Vista dan yang lebih baru.
 

Sintaks

BOOL EnumSystemLocalesEx(
  [in]           LOCALE_ENUMPROCEX lpLocaleEnumProcEx,
  [in]           DWORD             dwFlags,
  [in]           LPARAM            lParam,
  [in, optional] LPVOID            lpReserved
);

Parameter

[in] lpLocaleEnumProcEx

Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi. Fungsi EnumSystemLocalesEx menghitung lokal dengan melakukan panggilan berulang ke fungsi panggilan balik ini. Untuk informasi selengkapnya, lihat EnumLocalesProcEx.

[in] dwFlags

Bendera yang mengidentifikasi lokal untuk dijumlahkan. Bendera dapat digunakan secara senyap atau digabungkan menggunakan biner OR. Jika aplikasi menentukan 0 untuk parameter ini, fungsi bereaksi seperti untuk LOCALE_ALL.

[in] lParam

Parameter yang disediakan aplikasi untuk diteruskan ke fungsi panggilan balik. Ini sangat berguna untuk aplikasi multi-utas.

[in, optional] lpReserved

Dipesan; harus NULL.

Mengembalikan nilai

Mengembalikan nilai bukan nol jika berhasil, atau 0 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 lokal dengan meneruskan nama lokal, satu per satu, ke fungsi panggilan balik yang ditentukan aplikasi yang ditentukan oleh lpLocaleEnumProcEx. Enumerasi berlanjut hingga semua nama yang diinstal atau didukung telah diteruskan ke fungsi panggilan balik atau fungsi panggilan balik mengembalikan FALSE.

Pilihan untuk parameter dwFlags berbeda dari yang untuk EnumSystemLocales, yang harus membedakan antara lokal yang diinstal dan didukung.

Jika dwFlags menentukan LOCALE_ALTERNATE_SORTS, fungsi panggilan balik dipanggil untuk setiap lokal yang mewakili urutan pengurutan alternatif. Misalnya, default Spanyol (Spanyol) ke urutan sortir internasional, tetapi urutan sortir tradisional tersedia untuk pengurutan alternatif. Bahasa Jerman (Jerman) default ke urutan sortir kamus, tetapi ada urutan sortir buku telepon alternatif yang tersedia.

Contoh

Contoh yang menunjukkan penggunaan fungsi ini dapat ditemukan di NLS: Sampel API berbasis nama.

Persyaratan

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

Lihat juga

EnumLocalesProcEx

EnumSystemLocales

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional