Funktionen AllocConsoleWithOptions

Du kan också allokera en ny konsol för anropsprocessen, samtidigt som du kan ange synligheten för det nya konsolfönstret.

Syntax

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

Parameterar

allocOptions [in, optional] En ALLOC_CONSOLE_OPTIONS struktur som styr hur den här funktionen allokerar ett fönster.

result [out, optional] Tar emot något av följande värden:

Värde	Innebörd
ALLOC_CONSOLE_RESULT_NO_CONSOLE 0	Ingen konsol skapades eftersom ALLOC_CONSOLE_MODE_DEFAULT användes och den överordnade processen bad om att ingen skulle skapas.
ALLOC_CONSOLE_RESULT_NEW_CONSOLE 1	En ny konsolsession skapades som ett resultat av det här anropet. Det resulterande beteendet är identiskt med AllocConsole.
ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE 2	Processen har anslutit sig till en befintlig konsolsession och ärvts av den överordnade processen. Det resulterande beteendet är identiskt med AttachConsole.

Returvärde

Typ: HRESULT

Om den här metoden lyckas returneras S_OK. Annars returneras en HRESULT- felkod.

Anmärkningar

Till skillnad från Med AllocConsole eller AttachConsole resulterar det inte i något fel att anropa den här metoden när den redan är ansluten till en konsolsession. Resultatparametern anges till ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE i det fallet.

En process kan använda funktionen FreeConsole för att koppla från sig själv från den aktuella konsolen. En konsol stängs när den sista processen som är kopplad till den avslutas eller anropar FreeConsole.

Kravspecifikation

Lägsta klient som stöds	Windows 11 24H2 (version 26100) [endast skrivbordsappar]
Lägsta server som stöds	Windows Server 2025 (version 26100)
Rubrik	ConsoleApi.h (via WinCon.h, inkludera Windows.h)
Bibliotek	Kernel32.lib
DLL	Kernel32.dll

Se även

Konsolfunktioner

konsoler

Princip för konsolallokering

AllocConsole

AttachConsole

FreeConsole