ClosePseudoConsole függvény

Leállítja és felszabadítja az adott pszeudokonzolhoz társított erőforrásokat.

Szemantika

void WINAPI ClosePseudoConsole(
    _In_ HPCON hPC
);

Paraméterek

hPC [in]
A CreatePseudoConsole által megnyitott aktív pseudoconsole leírója.

Visszaadott érték

egyik sem

Megjegyzések

A pszeudokonzol bezárása küld egy CTRL_CLOSE_EVENT-et a még csatlakozó ügyfélalkalmazásoknak. Amíg az alkalmazások megszakadnak, további kimeneteket írhatnak. Emiatt az alkalmazás várhatóan bezárja a kimeneti csövet a ClosePseudoConsole hívása előtt, vagy folytassa az olvasást a csőből, amíg a ClosePseudoConsole vissza nem tér.

Megjegyzés:

A Windows 11 24H2 (26100-ás build) indításakor a ClosePseudoConsole azonnal visszatér a véletlen holtpontok elkerülése érdekében. A korábbi verziók határozatlan ideig várják a pszeudokonzol kilépését. Ha tudnia kell, hogy mikor szakadt meg az összes ügyfél kapcsolata, egyszerűen folytassa az olvasást a kimeneti csővezetékről, amíg be nem zárják.

Figyelmeztetés

A fentiek következtében a kimeneti cső bezárásának vagy ürítésének elmulasztása miatt a ClosePseudoConsole határozatlan ideig várakozhat a Windows korábbi verzióiban. A régebbi verziók holtpontjának elkerülése érdekében ne hívja meg a ClosePseudoConsole-t ugyanazon a szálon, amelyből a kimeneti csövet olvassa, kivéve, ha a kimeneti csövet korábban Ön bezárta, vagy a pseudoconsole bezárta Önre.

Követelmények

Minimálisan támogatott ügyfél	Windows 10 2018. októberi frissítés (1809-es verzió) [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows Server 2019 [csak asztali alkalmazások]
Fejléc	ConsoleApi.h (a WinCon.h-n keresztül, a Windows.h-t is belefoglalva)
Könyvtár	Kernel32.lib
DLL	Kernel32.dll

Lásd még

Pseudoconsoles

CreatePseudoConsole

ResizePseudoConsole