AllocConsoleWithOptions függvény

Opcionálisan lefoglal egy új konzolt a hívási folyamathoz, miközben megadhatja az új konzolablak láthatóságát.

Szemantika

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

Paraméterek

allocOptions [in, optional] Egy ALLOC_CONSOLE_OPTIONS struktúra, amely szabályozza, hogy ez a függvény hogyan foglalja le az ablakot.

result [out, optional] A következő értékek egyikét kapja meg:

Érték	Értelmezés
ALLOC_CONSOLE_RESULT_NO_CONSOLE 0	Nem jött létre konzol, mert az ALLOC_CONSOLE_MODE_DEFAULT volt használatban, és a szülőfolyamat nem kérte a létrehozását.
ALLOC_CONSOLE_RESULT_NEW_CONSOLE 1	A hívás eredményeként új konzolmunkamenet jött létre. Az eredményként kapott viselkedés megegyezik az AllocConsole-tal.
ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE 2	A folyamat egy meglévő konzolmunkamenethez csatolta magát, amelyet a szülőfolyamat örököl. Az eredményként kapott viselkedés megegyezik az AttachConsole-tal.

Visszaadott érték

Típus: HRESULT

Ha ez a módszer sikeres, S_OKad vissza. Ellenkező esetben egy HRESULT hibakódot ad vissza.

Megjegyzések

Az AllocConsole vagy az AttachConsole függvénytől eltérően a metódus meghívása, ha már csatlakozik egy konzolmunkamenethez, nem okoz hibát. Az eredményparaméter ebben az esetben ALLOC_CONSOLE_RESULT_EXISTING_CONSOLE lesz beállítva.

A folyamat a FreeConsole függvénnyel leválaszthatja magát az aktuális konzolról. A konzol akkor lesz bezárva, ha az utolsó hozzá csatolt folyamat leáll, vagy meghívja a FreeConsole-t.

Követelmények

Minimálisan támogatott ügyfél	Windows 11 24H2 (26100-ás build) [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows Server 2025 (26100-as verzió)
Fejléc	ConsoleApi.h (a WinCon.h-n keresztül, a Windows.h-t is belefoglalva)
Könyvtár	Kernel32.lib
DLL	Kernel32.dll

Lásd még

Konzolfüggvények

konzolok

Konzolkiosztási szabályzat

AllocConsole

AttachConsole

FreeConsole