Funkce ClosePseudoConsole

Vypne a uvolní prostředky přidružené k dané pseudokonsole.

Syntaxe

void WINAPI ClosePseudoConsole(
    _In_ HPCON hPC
);

Parametry

hPC [in]
Popisovač aktivní pseudokonsole otevřené createPseudoConsole.

Návratová hodnota

žádné

Poznámky

Zavření pseudokonsole pošle CTRL_CLOSE_EVENT do každé klientské aplikace, která je stále připojena. Dokud se aplikace neodpojí, mohou pokračovat v psaní dalšího výstupu. Z tohoto důvodu se očekává, že aplikace buď zavře výstupní kanál před voláním ClosePseudoConsole , nebo pokračovat ve čtení z kanálu, dokud se nevrátí ClosePseudoConsole .

Poznámka:

Počínaje Windows 11 24H2 (build 26100) ClosePseudoConsole se okamžitě vrátí, aby nedošlo k náhodnému zablokování. Starší verze budou čekat na neomezenou dobu, než se pseudokonsole ukončí. Pokud potřebujete vědět, kdy se všichni klienti odpojili, jednoduše pokračujte ve čtení z výstupního kanálu, dokud není uzavřen.

Výstraha

V důsledku výše uvedeného může selhání ukončení nebo vyprázdnění výstupního kanálu způsobit, že ClosePseudoConsole bude čekat neomezeně dlouho v dřívějších verzích Windows. Abyste se vyhnuli zablokování u starších verzí, nevolejte ClosePseudoConsole ve stejném vlákně, ze kterého čtete z výstupního potrubí, pokud jste výstupní potrubí předtím uzavřeli sami nebo pokud nebyl uzavřen pseudokonzolí.

Požadavky

Minimální podporovaný klient	Aktualizace Windows 10 z října 2018 (verze 1809) [jenom desktopové aplikace]
Minimální podporovaný server	Windows Server 2019 [jenom desktopové aplikace]
Záhlaví	ConsoleApi.h (přes WinCon.h, včetně Windows.h)
Knihovna	Kernel32.lib
knihovna DLL	Kernel32.dll

Viz také

Pseudokonsoles

CreatePseudoConsole

ResizePseudoConsole