Struktur CPINFOEXW (winnls.h)
Berisi informasi tentang halaman kode. Struktur ini digunakan oleh fungsi GetCPInfoEx .
Sintaks
typedef struct _cpinfoexW {
UINT MaxCharSize;
BYTE DefaultChar[MAX_DEFAULTCHAR];
BYTE LeadByte[MAX_LEADBYTES];
WCHAR UnicodeDefaultChar;
UINT CodePage;
WCHAR CodePageName[MAX_PATH];
} CPINFOEXW, *LPCPINFOEXW;
Anggota
MaxCharSize
Panjang maksimum, dalam byte, dari karakter di halaman kode. Panjangnya bisa 1 untuk kumpulan karakter byte tunggal (SBCS), 2 untuk kumpulan karakter byte ganda (DBCS), atau nilai yang lebih besar dari 2 untuk jenis kumpulan karakter lainnya. Fungsi tidak dapat menggunakan ukuran untuk membedakan SBCS atau DBCS dari set karakter lain karena faktor lain, misalnya, penggunaan halaman kode ISCII atau ISO-2022-xx.
DefaultChar[MAX_DEFAULTCHAR]
Karakter default yang digunakan saat menerjemahkan string karakter ke halaman kode tertentu. Karakter ini digunakan oleh fungsi WideCharToMultiByte jika karakter default eksplisit tidak ditentukan. Defaultnya biasanya adalah karakter "?" untuk halaman kode.
LeadByte[MAX_LEADBYTES]
Array rentang byte prospek dengan panjang tetap, yang jumlah rentang byte prospeknya bervariasi. Jika halaman kode tidak memiliki byte prospek, setiap elemen array diatur ke NULL. Jika halaman kode memiliki byte prospek, array menentukan nilai awal dan nilai akhir untuk setiap rentang. Rentang bersifat inklusif, dan jumlah maksimum rentang untuk halaman kode apa pun adalah lima. Array menggunakan dua byte untuk menjelaskan setiap rentang, dengan dua byte null sebagai terminator setelah rentang terakhir.
UnicodeDefaultChar
Karakter default Unicode yang digunakan dalam terjemahan dari halaman kode tertentu. Defaultnya biasanya adalah karakter "?" atau karakter titik tengah katakana. Karakter default Unicode digunakan oleh fungsi MultiByteToWideChar .
CodePage
Nilai halaman kode. Nilai ini mencerminkan halaman kode yang diteruskan ke fungsi GetCPInfoEx . Lihat Pengidentifikasi Halaman Kode untuk daftar ANSI dan halaman kode lainnya.
CodePageName[MAX_PATH]
Nama lengkap halaman kode. Perhatikan bahwa nama ini dilokalkan dan tidak dijamin keunikan atau konsistensi antara versi sistem operasi atau komputer.
Keterangan
Byte prospek unik untuk halaman kode DBCS yang memungkinkan lebih dari 256 karakter. Byte prospek adalah byte pertama dari karakter 2 byte dalam DBCS. Pada setiap halaman kode DBCS, byte prospek menempati rentang nilai byte tertentu. Rentang ini berbeda untuk halaman kode yang berbeda.
Informasi byte prospek tidak terlalu membantu untuk sebagian besar halaman kode, dan bahkan tidak disediakan untuk banyak pengodean multi-byte, misalnya, UTF-8 dan GB18030. Aplikasi Anda tidak dianjurkan untuk menggunakan informasi ini untuk memprediksi apa yang akan dilakukan fungsi MultiByteToWideChar atau WideCharToMultiByte . Fungsi mungkin berakhir menggunakan karakter default atau melakukan perilaku default lainnya jika byte yang mengikuti byte prospek tidak seperti yang diharapkan.
Catatan
Header winnls.h mendefinisikan CPINFOEX 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
| Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
| Header | winnls.h (termasuk Windows.h) |