Fungsi WriteConsoleInput
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.
Menulis data langsung ke buffer input konsol.
Sintaks
BOOL WINAPI WriteConsoleInput(
_In_ HANDLE hConsoleInput,
_In_ const INPUT_RECORD *lpBuffer,
_In_ DWORD nLength,
_Out_ LPDWORD lpNumberOfEventsWritten
);
Parameter
hConsoleInput [in]
Handel ke buffer input konsol. Handel harus memiliki akses GENERIC_WRITE yang tepat. Untuk informasi selengkapnya, lihat Keamanan dan Hak Akses Buffer Konsol.
lpBuffer [in]
Penunjuk ke array struktur INPUT_RECORD yang berisi data yang akan ditulis ke buffer input.
nLength [in]
Jumlah rekaman input yang akan ditulis.
lpNumberOfEventsWritten [out]
Pointer ke variabel yang menerima jumlah rekaman input yang benar-benar ditulis.
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
WriteConsoleInput menempatkan rekaman input ke dalam buffer input di belakang peristiwa yang tertunda di buffer. Buffer input tumbuh secara dinamis, jika perlu, untuk mengadakan peristiwa sebanyak yang ditulis.
Fungsi ini menggunakan karakter Unicode atau karakter 8-bit dari halaman kode konsol saat ini. Halaman kode konsol default awalnya ke halaman kode OEM sistem. Untuk mengubah halaman kode konsol, gunakan fungsi SetConsoleCP atau SetConsoleOutputCP. Konsumen warisan juga dapat menggunakan perintah chcp atau mode con cp select= , tetapi tidak disarankan untuk pengembangan baru.
Tip
API ini tidak disarankan dan tidak memiliki terminal virtual yang setara. Keputusan ini sengaja menyelaraskan platform Windows dengan sistem operasi lainnya. Operasi ini dianggap kata kerja yang salah untuk buffer ini. 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 |
Nama Unicode dan ANSI | WriteConsoleInputW (Unicode) dan WriteConsoleInputA (ANSI) |