Fungsi GetCPInfoExA (winnls.h)

Artikel
03/09/2024

Mengambil informasi tentang halaman kode yang terinstal atau tersedia yang valid.

Sintaks

BOOL GetCPInfoExA(
  [in]  UINT        CodePage,
  [in]  DWORD       dwFlags,
  [out] LPCPINFOEXA lpCPInfoEx
);

Parameter

[in] CodePage

Pengidentifikasi untuk halaman kode untuk mengambil informasi. Aplikasi dapat menentukan pengidentifikasi halaman kode untuk halaman kode yang diinstal atau tersedia, atau salah satu nilai yang telah ditentukan sebelumnya berikut. Lihat Pengidentifikasi Halaman Kode untuk daftar pengidentifikasi untuk ANSI dan halaman kode lainnya.

Nilai	Makna
CP_ACP	Gunakan halaman kode Windows ANSI default sistem.
CP_MACCP	Gunakan halaman kode Macintosh default sistem.
CP_OEMCP	Gunakan halaman kode OEM default sistem.
CP_THREAD_ACP	Gunakan halaman kode ANSI utas saat ini.

[in] dwFlags

Dipesan; harus 0.

[out] lpCPInfoEx

Penunjuk ke struktur CPINFOEX yang menerima informasi tentang halaman kode.

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_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Informasi yang diambil dalam struktur CPINFOEX tidak selalu berguna untuk semua halaman kode. Untuk menentukan ukuran buffer, misalnya, aplikasi harus memanggil MultiByteToWideChar atau WideCharToMultiByte untuk meminta ukuran buffer yang akurat. Jika pengaturan CPINFOEX menunjukkan bahwa byte prospek ada, fungsi konversi tidak selalu menangani byte prospek secara berbeda, misalnya, dalam kasus byte jejak yang hilang atau ilegal.

Catatan

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