ClosePseudoConsole-functie

Hiermee worden de pseudoconsole afgesloten en de bijbehorende resources vrijgegeven.

Syntaxis

void WINAPI ClosePseudoConsole(
    _In_ HPCON hPC
);

Parameterwaarden

hPC [in]
Een ingang naar een actieve pseudoconsole zoals geopend door CreatePseudoConsole.

Retourwaarde

geen

Opmerkingen

Als u een pseudoconsole sluit, wordt CTRL_CLOSE_EVENT verzonden naar elke clienttoepassing die nog steeds is verbonden. Totdat de verbinding met de toepassingen is verbroken, kunnen ze doorgaan met het schrijven van meer uitvoer. Daarom wordt verwacht dat uw toepassing de uitvoerpijp sluit voordat u ClosePseudoConsole aanroept of doorgaat met lezen vanuit de pijp totdat ClosePseudoConsole is geretourneerd.

Opmerking

Vanaf Windows 11 24H2 (build 26100) zal ClosePseudoConsole onmiddellijk terugkeren om onbedoelde impasses te voorkomen. Eerdere versies wachten onbeperkt totdat de pseudoconsole is afgesloten. Als u wilt weten wanneer alle clients de verbinding hebben verbroken, kunt u doorgaan met lezen van de uitvoerpijp totdat deze op u is gesloten.

Waarschuwing

Als gevolg van het bovenstaande kan het niet sluiten of leegmaken van de uitvoerpijp ertoe leiden dat ClosePseudoConsole voor onbepaalde tijd wacht in eerdere versies van Windows. Als u impasses in oudere versies wilt voorkomen, roept u ClosePseudoConsole niet aan op dezelfde thread waaruit u de uitvoerpijp leest, tenzij de uitvoerpijp eerder door u is gesloten of gesloten door de pseudoconsole.

Behoeften

Minimaal ondersteunde client	Update voor Windows 10 oktober 2018 (versie 1809) [alleen desktop-apps]
Minimaal ondersteunde server	Windows Server 2019 [alleen desktop-apps]
Koptekst	ConsoleApi.h (via WinCon.h, inclusief Windows.h)
Bibliotheek	Kernel32.lib
DLL	Kernel32.dll

Zie ook

Pseudoconsoles

CreatePseudoConsole

Formaat vanPseudoConsole wijzigen