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, opcional] Uma estrutura ALLOC_CONSOLE_OPTIONS que controla como essa função aloca uma janela.

resultado [out, opcional] Recebe um dos seguintes valores:

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

Valor retornado

Digite: HRESULT

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

Observações

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

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

Requisitos

Cliente mínimo com suporte	Windows 11 24H2 (build 26100) [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2025 (build 26100)
Cabeçalho	ConsoleApi.h (via WinCon.h, incluir Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Consulte também

Funções de console

Consoles

Política de Alocação do Console

AllocConsole

AttachConsole

FreeConsole