Fungsi GetCPInfoExW (winnls.h)

Artikel
11/20/2024

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

Sintaksis

BOOL GetCPInfoExW(
  [in]  UINT        CodePage,
  [in]  DWORD       dwFlags,
  [out] LPCPINFOEXW 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	Arti
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.

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

Komentar

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.

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Platform Target	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

CPINFOEX

GetACP

GetCPInfo

GetOEMCP

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

Bagikan melalui