Fungsi SetConsoleScreenBufferInfoEx

Artikel
12/13/2023

Penting

Dokumen ini menjelaskan fungsionalitas platform konsol yang tidak lagi menjadi bagian dari peta jalan ekosistem kami. Kami tidak menyarankan penggunaan konten ini dalam produk baru, tetapi kami akan terus mendukung penggunaan yang ada untuk masa depan yang tidak terbatas. Solusi modern pilihan kami berfokus pada urutan terminal virtual untuk kompatibilitas maksimum dalam skenario lintas platform. Anda dapat menemukan informasi selengkapnya tentang keputusan desain ini di konsol klasik vs. dokumen terminal virtual kami.

Mengatur informasi yang diperluas tentang buffer layar konsol yang ditentukan.

Sintaks

BOOL WINAPI SetConsoleScreenBufferInfoEx(
  _In_ HANDLE                        hConsoleOutput,
  _In_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);

Parameter

hConsoleOutput [in]
Handel ke buffer layar konsol. Handel harus memiliki akses GENERIC_WRITE yang tepat. Untuk informasi selengkapnya, lihat Keamanan dan Hak Akses Buffer Konsol.

lpConsoleScreenBufferInfoEx [in]
Struktur CONSOLE_SCREEN_BUFFER_INFOEX yang berisi informasi buffer layar konsol.

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

Tip

API ini memiliki terminal virtual parsial yang setara. Buffer posisi kursor dan atribut teks memiliki urutan tertentu yang setara. Tabel warna tidak dapat dikonfigurasi, tetapi warna yang diperluas tersedia di luar apa yang biasanya tersedia melalui fungsi konsol. Atribut popup tidak setara dengan menu popup adalah tanggung jawab aplikasi klien baris perintah di dunia terminal virtual. Akhirnya, ukuran jendela dan status layar penuh dianggap sebagai hak istimewa yang dimiliki oleh pengguna di dunia terminal virtual dan tidak memiliki urutan yang setara.

Persyaratan


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

Bagikan melalui