Función ClosePseudoConsole

Cierra y libera los recursos asociados a la pseudoconsola especificada.

Sintaxis

void WINAPI ClosePseudoConsole(
    _In_ HPCON hPC
);

Parámetros

hPC [in]
Identificador de una pseudoconsola activa, según la abre CreatePseudoConsole.

Valor devuelto

ninguno

Observaciones

Al cerrar una pseudoconsola, se enviará CTRL_CLOSE_EVENT a cada aplicación cliente que todavía está conectada. Hasta que las aplicaciones se hayan desconectado, pueden seguir escribiendo más salida. Debido a esto, se espera que la aplicación cierre la canalización de salida antes de llamar a ClosePseudoConsole o que continúe leyendo desde la canalización hasta después de que ClosePseudoConsole haya completado su ejecución.

Nota:

A partir de Windows 11 24H2 (compilación 26100) ClosePseudoConsole retornará inmediatamente para evitar interbloqueos accidentales. Las versiones anteriores esperarán indefinidamente para que se cierre la pseudoconsola. Si necesita saber cuándo todos los clientes se han desconectado, simplemente siga leyendo desde el conducto de salida hasta que se cierre.

Advertencia

Como consecuencia de lo anterior, el error al cerrar o purgar la canalización de salida puede provocar que ClosePseudoConsole espere indefinidamente en versiones anteriores de Windows. Para evitar interbloqueos en versiones anteriores, no llame a ClosePseudoConsole en el mismo subproceso desde el que está leyendo la canalización de salida, a menos que haya cerrado previamente usted mismo la canalización de salida o que el pseudoconsola la haya cerrado por usted.

Requisitos

Cliente mínimo compatible	Actualización de octubre de 2018 de Windows 10 (versión 1809) [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2019 [solo aplicaciones de escritorio]
Cabecera	ConsoleApi.h (a través de WinCon.h, incluye Windows.h)
Biblioteca	Kernel32.lib
Archivo DLL	Kernel32.dll

Consulte también

Pseudoconsolas

CreatePseudoConsole

ResizePseudoConsole