Fungsi EnumSystemCodePagesA (winnls.h)

Menghitung halaman kode yang diinstal atau didukung oleh sistem operasi.

Sintaks

BOOL EnumSystemCodePagesA(
  [in] CODEPAGE_ENUMPROCA lpCodePageEnumProc,
  [in] DWORD              dwFlags
);

Parameter

[in] lpCodePageEnumProc

Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi. Fungsi EnumSystemCodePages menghitung halaman kode dengan melakukan panggilan berulang ke fungsi panggilan balik ini. Untuk informasi selengkapnya, lihat EnumCodePagesProc.

[in] dwFlags

Bendera yang menentukan halaman kode untuk dijumlahkan. Parameter ini dapat memiliki salah satu nilai berikut, yang saling eksklusif.

Nilai Makna
CP_INSTALLED
Hitung hanya halaman kode yang terinstal.
CP_SUPPORTED
Hitung semua halaman kode yang didukung.

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 halaman kode dengan meneruskan pengidentifikasi halaman kode, satu per satu, ke fungsi panggilan balik yang ditentukan aplikasi yang ditentukan. Proses ini berlanjut hingga semua pengidentifikasi halaman kode yang diinstal atau didukung telah diteruskan ke fungsi panggilan balik, atau fungsi panggilan balik mengembalikan FALSE.

Ketika aplikasi menggunakan fungsi ini untuk menentukan halaman kode yang sesuai untuk menyimpan data, aplikasi harus menggunakan Unicode jika memungkinkan. Halaman kode lain tidak portabel seperti Unicode antara vendor atau sistem operasi, karena implementasi yang berbeda dari standar terkait.

Catatan

Header winnls.h mendefinisikan EnumSystemCodePages 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

Lihat juga

EnumCodePagesProc

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional