Fungsi EnumSystemCodePagesW (winnls.h)

Artikel
03/13/2024

Menghitung halaman kode yang diinstal atau didukung oleh sistem operasi.

Sintaks

BOOL EnumSystemCodePagesW(
  [in] CODEPAGE_ENUMPROCW 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.

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 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

Bagikan melalui