Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Desliga e libera recursos associados ao pseudoconsole especificado.
Sintaxe
void WINAPI ClosePseudoConsole(
_In_ HPCON hPC
);
Parâmetros
hPC [em]
Um identificador para um pseudoconsole ativo como aberto pelo CreatePseudoConsole.
Valor retornado
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 resultados. Por isso, espera-se que seu aplicativo feche o pipe de saída antes de chamar ClosePseudoConsole ou continue lendo do pipe até que ClosePseudoConsole tenha retornado.
Observação
Ao iniciar o Windows 11 24H2 (build 26100), ClosePseudoConsole retornará imediatamente para evitar deadlocks 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 do pipe de saída até que ele tenha sido fechado em você.
Aviso
Como consequência do exposto acima, a falha ao fechar ou esvaziar o pipe de saída pode fazer com que ClosePseudoConsole aguarde indefinidamente nas versões anteriores do Windows. Para evitar deadlocks 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 por você pelo pseudoconsole.
Requisitos
| Cliente mínimo com suporte | Atualização de outubro de 2018 do Windows 10 (versão 1809) [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2019 [somente aplicativos da área de trabalho] |
| Cabeçalho | ConsoleApi.h (via WinCon.h, inclui o Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |