Fungsi EnumSystemLocalesW (winnls.h)

Artikel
08/27/2023

Menghitung lokal yang diinstal pada atau didukung oleh sistem operasi.

Catatan Untuk alasan interoperabilitas, aplikasi harus lebih memilih fungsi EnumSystemLocalesEx ke EnumSystemLocales karena Microsoft bermigrasi ke penggunaan nama lokal alih-alih pengidentifikasi lokal untuk lokal baru. Aplikasi apa pun yang hanya akan dijalankan pada Windows Vista dan nantinya harus menggunakan EnumSystemLocalesEx.

Sintaks

BOOL EnumSystemLocalesW(
  [in] LOCALE_ENUMPROCW lpLocaleEnumProc,
  [in] DWORD            dwFlags
);

Parameter

[in] lpLocaleEnumProc

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

[in] dwFlags

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

Nilai	Makna
LCID_INSTALLED	Hitung hanya pengidentifikasi lokal yang terinstal. Nilai ini tidak dapat digunakan dengan LCID_SUPPORTED.
LCID_SUPPORTED	Menghitung semua pengidentifikasi lokal yang didukung. Nilai ini tidak dapat digunakan dengan LCID_INSTALLED.
LCID_ALTERNATE_SORTS	Hitung hanya pengidentifikasi lokal pengurutan alternatif. Jika nilai ini digunakan dengan LCID_INSTALLED atau LCID_SUPPORTED, lokal yang diinstal atau didukung diambil, serta pengidentifikasi lokal pengurutan alternatif.

Nilai kembali

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

Keterangan

Fungsi ini menghitung lokal dengan meneruskan pengidentifikasi lokal, satu per satu, ke fungsi panggilan balik yang ditentukan aplikasi yang ditentukan. Ini berlanjut sampai semua pengidentifikasi lokal yang diinstal atau didukung telah diteruskan ke fungsi panggilan balik atau fungsi panggilan balik mengembalikan FALSE.

Catatan

Header winnls.h mendefinisikan EnumSystemLocales sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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

Lihat juga

EnumLocalesProc

EnumSystemLocalesEx

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

Bagikan melalui