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 |
---|---|
|
Hitung hanya halaman kode yang terinstal. |
|
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk