Função AllocConsole

Aloca um novo console para o processo de chamada.

Sintaxe

BOOL WINAPI AllocConsole(void);

Parâmetros

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

Valor de retorno

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

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

Observações

Um processo pode ser associado a apenas um console, portanto, a função AllocConsole falhará se o processo de chamada já tiver um console. Um processo pode usar a função FreeConsole para se separar de seu console atual, então ele pode chamar AllocConsole para criar um novo console ou AttachConsole para se conectar a outro console.

Se o processo de chamada criar um processo filho, o filho herdará o novo console.

AllocConsole inicializa os handles de entrada padrão, saída padrão e erro padrão para o novo console. O manipulador de entrada padrão é um manipulador associado ao buffer de entrada do console, e os manipuladores de saída padrão e erro padrão são associados ao buffer de tela do console. Para recuperar essas alças, use a função GetStdHandle.

Esta função é usada principalmente por um aplicativo de interface gráfica do usuário (GUI) para criar uma janela de console. Os aplicativos GUI são inicializados sem um console. Os aplicativos de console são inicializados com um console, a menos que sejam criados como processos desanexados (chamando a função CreateProcess com o sinalizador DETACHED_PROCESS ).

Requerimentos


Cliente mínimo suportado	Windows 2000 Professional [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado	Windows 2000 Server [apenas aplicações de ambiente de trabalho]
Cabeçalho	ConsoleApi.h (via WinCon.h, inclui Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll