Função ClosePseudoConsole

Desliga e libera recursos associados ao pseudoconsole fornecido.

Sintaxe

void WINAPI ClosePseudoConsole(
    _In_ HPCON hPC
);

Parâmetros

hPC [em]
Um identificador para um pseudoconsole ativo tal como aberto por CreatePseudoConsole.

Valor de retorno

nenhum

Observações

Fechar um pseudoconsole enviará CTRL_CLOSE_EVENT para cada aplicativo cliente que ainda está conectado. Até que os aplicativos tenham se desconectado, eles podem continuar gravando mais saída. Devido a isso, espera-se que seu aplicativo feche o pipe de saída antes de chamar ClosePseudoConsole ou continue lendo do pipe até que ClosePseudoConsole retorne.

Observação

Iniciando o Windows 11 24H2 (build 26100) ClosePseudoConsole retornará imediatamente para evitar bloqueios acidentais. As versões anteriores aguardarão indefinidamente a saída do pseudoconsole. Se você precisar saber quando todos os clientes se desconectaram, basta continuar lendo a partir do tubo de saída até que ele tenha sido fechado em você.

Advertência

Como consequência do acima, a falha em fechar ou drenar o tubo de saída pode fazer com que o ClosePseudoConsole aguarde indefinidamente em versões anteriores do Windows. Para evitar bloqueios em versões mais antigas, não chame ClosePseudoConsole no mesmo thread do qual você está lendo o pipe de saída, a menos que o pipe de saída tenha sido fechado anteriormente por você ou fechado em você pelo pseudoconsole.

Requerimentos


Cliente mínimo suportado	Atualização de outubro de 2018 do Windows 10 (versão 1809) [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado	Windows Server 2019 [apenas aplicações de ambiente de trabalho]
Cabeçalho	ConsoleApi.h (via WinCon.h, inclui Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll