Compartilhar via


Função FreeConsole

Desanexa o processo de chamada de seu console.

Sintaxe

BOOL WINAPI FreeConsole(void);

Parâmetros

Essa função não tem parâmetros.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Um processo pode ser anexado a um console, no máximo. Um processo pode usar a função FreeConsole para se desanexar de seu console. Se outros processos compartilharem o console, o console não será destruído, mas o processo que chamou FreeConsole não poderá referenciá-lo. Consoles são fechados quando o último processo anexado a eles termina ou chama FreeConsole. Quando um processo chama FreeConsole, ele pode usar a função AllocConsole para criar um novo console ou AttachConsole para se anexar a outro console. Se o processo de chamada ainda não estiver conectado a um console, a solicitação de FreeConsole ainda será bem-sucedida.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho ConsoleApi.h (via WinCon.h, inclui o Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

AllocConsole

AttachConsole

Funções de Console

Consoles