Função AllocConsoleWithOptions

Opcionalmente, aloca um novo console para o processo de chamada, permitindo que você especifique a visibilidade da nova janela do console.

Sintaxe

HRESULT WINAPI AllocConsoleWithOptions(
    _In_opt_  PALLOC_CONSOLE_OPTIONS allocOptions,
    _Out_opt_ PALLOC_CONSOLE_RESULT  result
);

Parâmetros

allocOptions [in, optional] Uma estrutura ALLOC_CONSOLE_OPTIONS que controla como essa função aloca uma janela.

result [out, optional] Recebe um dos seguintes valores:

Valor	Significado
ALLOC_CONSOLE_RESULT_NO_CONSOLE 0	Nenhum console foi criado porque o ALLOC_CONSOLE_MODE_DEFAULT foi usado e o processo pai não solicitou a criação de nenhum.
ALLOC_CONSOLE_RESULT_NEW_CONSOLE 1	Uma nova sessão de console foi criada como resultado dessa chamada. O comportamento resultante é idêntico ao AllocConsole.
ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE 2	O processo foi anexado a uma sessão de consola existente, herdada pelo processo pai. O comportamento resultante é idêntico ao AttachConsole.

Valor de retorno

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retorna um HRESULT código de erro.

Observações

Ao contrário de AllocConsole ou AttachConsole, chamar esse método quando já conectado a uma sessão de console não resulta em um erro. O parâmetro result será definido como ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE nesse caso.

Um processo pode usar a função FreeConsole para se separar de seu console atual. Um console é fechado quando o último processo anexado a ele termina ou chama FreeConsole.

Requerimentos


Cliente mínimo suportado	Windows 11 24H2 (compilação 26100) [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado	Windows Server 2025 (compilação 26100)
Cabeçalho	ConsoleApi.h (via WinCon.h, inclui Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll