Função AllocConsole

Artigo
12/13/2023

Aloca um novo console para o processo de chamada.

Sintaxe

BOOL WINAPI AllocConsole(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 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 desanexar do console atual. Depois, ele pode chamar AllocConsole para criar um console ou AttachConsole para se anexar a outro console.

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

O AllocConsole inicializa os identificadores de entrada padrão, de saída padrão e de erro padrão no novo console. O identificador de entrada padrão é um identificador para o buffer de entrada do console e os identificadores de saída padrão e de erro padrão são identificadores do buffer de tela do console. Para recuperar esses identificadores, use a função GetStdHandle.

Essa função é usada principalmente por um aplicativo da GUI (interface gráfica do usuário) para criar uma janela de console. Os aplicativos da GUI são inicializados sem um console. Os aplicativos do 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).

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