Funkcja ClosePseudoConsole

Zamyka i zwalnia zasoby skojarzone z danym pseudokonsole.

Składnia

void WINAPI ClosePseudoConsole(
    _In_ HPCON hPC
);

Parametry

hPC [in]
Uchwyt do aktywnej pseudokonsoli otwartej przez CreatePseudoConsole.

Wartość zwracana

żaden

Uwagi

Zamknięcie pseudokonsole spowoduje wysłanie CTRL_CLOSE_EVENT do każdej aplikacji klienckiej, która jest nadal połączona. Dopóki aplikacje nie zostaną rozłączone, mogą kontynuować pisanie większej liczby danych wyjściowych. W związku z tym, aplikacja powinna zamknąć potok wyjściowy przed wywołaniem metody ClosePseudoConsole, lub kontynuować odczytywanie z potoku do czasu aż zostanie zwrócony przez ClosePseudoConsole.

Uwaga / Notatka

Uruchomienie systemu Windows 11 24H2 (kompilacja 26100) ClosePseudoConsole powróci natychmiast, aby uniknąć przypadkowych zakleszczeń. Wcześniejsze wersje będą czekać bezterminowo na zakończenie pseudokonsole. Jeśli musisz wiedzieć, kiedy wszyscy klienci się rozłączyli, po prostu kontynuuj odczytywanie z potoku wyjściowego, dopóki nie zostanie zamknięty.

Ostrzeżenie

W wyniku powyższego niepowodzenie zamknięcia lub opróżnienia potoku wyjściowego może spowodować, że ClosePseudoConsole będzie czekać na czas nieokreślony we wcześniejszych wersjach systemu Windows. Aby uniknąć zakleszczenia w starszych wersjach, nie należy wywoływać ClosePseudoConsole na tym samym wątku, z którego czytasz potok wyjściowy, chyba że potok wyjściowy został wcześniej zamknięty przez użytkownika lub zamknięty przez pseudokonsolę.

Wymagania

Minimalny obsługiwany klient	Aktualizacja Windows 10 October 2018 (wersja 1809) [tylko aplikacje desktopowe]
Minimalny obsługiwany serwer	Windows Server 2019 [tylko aplikacje komputerowe]
Nagłówek	ConsoleApi.h (za pośrednictwem WinCon.h, zawierając Windows.h)
Biblioteka	Kernel32.lib
DLL	Kernel32.dll

Zobacz także

Pseudokonsoles

CreatePseudoConsole

Zmienianie rozmiaru pseudoConsole