Função AllocConsole

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.

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 desanexar do console atual e, em seguida, pode chamar AllocConsole para criar um novo console ou AttachConsole para 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 de GUI (interface gráfica do usuário) para criar uma janela de console. Os aplicativos de 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 ).

Requisitos

Consulte também

Funções de console

Consoles

AllocConsoleWithOptions

AttachConsole

CreateProcess

FreeConsole

GetStdHandle