Fungsi SetConsoleCP

Artikel
12/13/2023

Mengatur halaman kode input yang digunakan oleh konsol yang terkait dengan proses panggilan. Konsol menggunakan halaman kode inputnya untuk menerjemahkan input keyboard ke dalam nilai karakter yang sesuai.

Sintaks

BOOL WINAPI SetConsoleCP(
  _In_ UINT wCodePageID
);

Parameter

wCodePageID [in]
Pengidentifikasi halaman kode yang akan diatur. Untuk informasi selengkapnya, lihat Keterangan.

Nilai hasil

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Halaman kode memetakan 256 kode karakter ke karakter individual. Halaman kode yang berbeda mencakup karakter khusus yang berbeda, biasanya disesuaikan untuk bahasa atau sekelompok bahasa.

Untuk menemukan halaman kode yang diinstal atau didukung oleh sistem operasi, gunakan fungsi EnumSystemCodePages. Pengidentifikasi halaman kode yang tersedia di komputer lokal juga disimpan di registri di bawah kunci berikut:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage

Namun, lebih baik menggunakan EnumSystemCodePages untuk menghitung halaman kode karena registri dapat berbeda dalam versi Windows yang berbeda.

Untuk menentukan apakah halaman kode tertentu valid, gunakan fungsi IsValidCodePage. Untuk mengambil informasi selengkapnya tentang halaman kode, termasuk namanya, gunakan fungsi GetCPInfoEx. Untuk daftar pengidentifikasi halaman kode yang tersedia, lihat Pengidentifikasi Halaman Kode.

Untuk menentukan halaman kode input konsol saat ini, gunakan fungsi GetConsoleCP. Untuk mengatur dan mengambil halaman kode output konsol, gunakan fungsi SetConsoleOutputCP dan GetConsoleOutputCP.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	ConsoleApi2.h (melalui WinCon.h, termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Bagikan melalui