Fungsi ClosePseudoConsole

Mematikan dan melepaskan sumber daya yang terkait dengan pseudoconsole yang diberikan.

Sintaksis

void WINAPI ClosePseudoConsole(
    _In_ HPCON hPC
);

Parameter-parameternya

hPC [in]
Handle ke pseudoconsole aktif sebagaimana yang dibuka oleh CreatePseudoConsole.

Mengembalikan nilai

Tidak ada

Komentar

Menutup pseudoconsole akan mengirim CTRL_CLOSE_EVENT ke setiap aplikasi klien yang masih terhubung. Sampai aplikasi terputus, aplikasi dapat terus menulis lebih banyak output. Karena itu, aplikasi Anda diharapkan untuk menutup pipa output sebelum memanggil ClosePseudoConsole atau untuk terus membaca dari pipa sampai setelah ClosePseudoConsole kembali.

Nota

Pada Windows 11 24H2 (build 26100) ClosePseudoConsole akan segera dikembalikan untuk menghindari kebuntuan yang tidak disengaja. Versi sebelumnya akan menunggu tanpa batas waktu hingga pseudoconsole keluar. Jika Anda perlu tahu kapan semua klien terputus, cukup lanjutkan membaca dari saluran keluar sampai saluran tersebut ditutup untuk Anda.

Peringatan

Sebagai konsekuensi dari hal di atas, kegagalan untuk menutup atau menguras pipa output dapat menyebabkan ClosePseudoConsole menunggu tanpa batas waktu di versi Windows sebelumnya. Untuk menghindari kebuntuan pada versi yang lebih lama, jangan panggil ClosePseudoConsole pada utas yang sama dengan utas yang digunakan untuk membaca pipa keluaran, kecuali jika pipa keluaran tersebut sebelumnya sudah ditutup oleh Anda atau ditutup oleh pseudokonsol.

Persyaratan

Klien minimum yang didukung	Pembaruan Windows 10 Oktober 2018 (versi 1809) [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2019 [hanya aplikasi desktop]
Kepala Halaman	ConsoleApi.h (melalui WinCon.h, sertakan Windows.h)
Perpustakaan	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Pseudoconsoles

CreatePseudoConsole

Mengubah ukuranPseudoConsole