Fungsi ReadConsoleOutputAttribute
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.
Menyalin sejumlah atribut karakter tertentu dari sel berturut-turut dari buffer layar konsol, dimulai pada lokasi tertentu.
Sintaks
BOOL WINAPI ReadConsoleOutputAttribute(
_In_ HANDLE hConsoleOutput,
_Out_ LPWORD lpAttribute,
_In_ DWORD nLength,
_In_ COORD dwReadCoord,
_Out_ LPDWORD lpNumberOfAttrsRead
);
Parameter
hConsoleOutput [in]
Handel ke buffer layar konsol. Handel harus memiliki akses GENERIC_READ yang tepat. Untuk informasi selengkapnya, lihat Keamanan dan Hak Akses Buffer Konsol.
lpAttribute [out]
Penunjuk ke buffer yang menerima atribut yang digunakan oleh buffer layar konsol.
Untuk informasi selengkapnya, lihat Atribut Karakter.
nLength [in]
Jumlah sel karakter buffer layar yang akan dibaca. Ukuran buffer yang ditujukkan oleh parameter lpAttribute harus nLength * sizeof(WORD).
dwReadCoord [in]
Koordinat sel pertama di buffer layar konsol tempat membaca karakter. Anggota X dari struktur COORD adalah kolom , dan anggota Y adalah baris .
lpNumberOfAttrsRead [out]
Pointer ke variabel yang menerima jumlah atribut yang benar-benar dibaca.
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
Jika jumlah atribut yang akan dibaca dari memperluas di luar akhir baris buffer layar yang ditentukan, atribut akan dibaca dari baris berikutnya. Jika jumlah atribut yang akan dibaca dari memperluas di luar akhir buffer layar konsol, atribut hingga akhir buffer layar konsol akan dibaca.
Tip
API ini tidak disarankan dan tidak memiliki terminal virtual yang setara. Keputusan ini sengaja menyelaraskan platform Windows dengan sistem operasi lain di mana aplikasi klien individu diharapkan untuk mengingat status yang ditarik sendiri untuk manipulasi lebih lanjut. Aplikasi jarak jauh melalui utilitas lintas platform dan transportasi seperti SSH mungkin tidak berfungsi seperti yang diharapkan jika menggunakan API ini.
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 |