ALLOC_CONSOLE_OPTIONS structure

Controls how AllocConsoleWithOptions allocates a console window.

Syntax

typedef struct _ALLOC_CONSOLE_OPTIONS {
    ALLOC_CONSOLE_MODE mode;
    BOOL               useShowWindow;
    WORD               showWindow;
} ALLOC_CONSOLE_OPTIONS, *PALLOC_CONSOLE_OPTIONS;

Members

mode This parameter can be one of the following values:

Value	Meaning
ALLOC_CONSOLE_MODE_DEFAULT 0	Allocate a console session if one was requested by the parent process.
ALLOC_CONSOLE_MODE_NEW_WINDOW 1	Allocate a console session with a window, even if this process was created with CREATE_NO_CONSOLE or DETACHED_PROCESS.
ALLOC_CONSOLE_MODE_NO_WINDOW 2	Allocate a console session without a window, even if this process was created with CREATE_NEW_WINDOW or DETACHED_PROCESS.

useShowWindow Specifies whether the showWindow parameter should be used.

showWindow If useShowWindow is TRUE, this specifies the nCmdShow used to show the console window. See ShowWindow for more information.

Requirements

Minimum supported client	Windows 11 24H2 (build 26100) [desktop apps only]
Minimum supported server	Windows Server 2025 (build 26100)
Header	ConsoleApi.h (via WinCon.h, include Windows.h)

See also

AllocConsoleWithOptions