Funzione ClosePseudoConsole

Arresta e rilascia le risorse associate alla pseudoconsole specificata.

Sintassi

void WINAPI ClosePseudoConsole(
    _In_ HPCON hPC
);

Parametri

hPC [in]
Handle per una pseudoconsole attiva aperta da CreatePseudoConsole.

Valore restituito

nessuno

Osservazioni:

La chiusura di una pseudoconsole invierà CTRL_CLOSE_EVENT a ogni applicazione client ancora connessa. Fino a quando le applicazioni non sono disconnesse, potrebbero continuare a scrivere più output. Per questo motivo, l'applicazione dovrebbe chiudere la pipe di output prima di chiamare ClosePseudoConsole o continuare la lettura dalla pipe fino a quando non viene restituito ClosePseudoConsole .

Annotazioni

A partire da Windows 11 24H2 (build 26100) ClosePseudoConsole restituirà immediatamente per evitare deadlock accidentali. Le versioni precedenti attenderanno a tempo indeterminato l'uscita della pseudoconsole. Se è necessario sapere quando tutti i client si sono disconnessi, continua semplicemente a leggere dalla pipe di output finché non viene chiusa automaticamente.

Avvertimento

Di conseguenza, il mancato chiudere o svuotare la pipe di output può far sì che ClosePseudoConsole attenda indefinitamente nelle versioni precedenti di Windows. Per evitare situazioni di deadlock nelle versioni precedenti, non chiamare ClosePseudoConsole sullo stesso thread da cui si legge la pipe di output, a meno che la pipe di output non sia stata precedentemente chiusa da te o automaticamente dalla pseudoconsole.

Requisiti

Client minimo supportato	Aggiornamento di Windows 10 di ottobre 2018 (versione 1809) [solo app desktop]
Server minimo supportato	Windows Server 2019 [solo applicazioni desktop]
Intestazione	ConsoleApi.h (tramite WinCon.h, includere Windows.h)
Libreria	kernel32.lib
DLL	Kernel32.dll

Vedere anche

Pseudoconsole

CreatePseudoConsole

ResizePseudoConsole