Fungsi GetConsoleWindow
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.
Mengambil handel jendela yang digunakan oleh konsol yang terkait dengan proses panggilan.
HWND WINAPI GetConsoleWindow(void);
Fungsi ini tidak memiliki parameter.
Nilai pengembalian adalah handel ke jendela yang digunakan oleh konsol yang terkait dengan proses panggilan atau NULL jika tidak ada konsol terkait tersebut.
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0500 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.
Tip
API ini tidak disarankan dan tidak memiliki terminal virtual yang setara. Keputusan ini sengaja menyelaraskan platform Windows dengan sistem operasi lainnya. Status ini hanya relevan dengan konteks pengguna, sesi, dan hak istimewa lokal. Aplikasi jarak jauh melalui utilitas lintas platform dan transportasi seperti SSH mungkin tidak berfungsi seperti yang diharapkan jika menggunakan API ini.
Untuk aplikasi yang dihosting di dalam sesi pseudoconsole , fungsi ini mengembalikan handel jendela hanya untuk tujuan antrean pesan. Jendela terkait tidak ditampilkan secara lokal karena pseudoconsole menserialisasikan semua tindakan ke aliran untuk presentasi di jendela terminal lain di tempat lain.
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Header | ConsoleApi3.h (melalui WinCon.h, termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |