AllocConsole függvény

Új konzolt foglal le a hívási folyamathoz.

Szemantika

BOOL WINAPI AllocConsole(void);

Paraméterek

Ez a függvény nem rendelkezik paraméterekkel.

Visszaadott érték

Ha a függvény sikeres, a visszatérési érték nem lesz nulla.

Ha a függvény sikertelen, a visszatérési érték nulla. A kiterjesztett hibainformációk lekéréséhez hívja meg a GetLastErrort.

Megjegyzések

Egy folyamat csak egy konzolhoz társítható, ezért az AllocConsole függvény meghiúsul, ha a hívási folyamat már rendelkezik konzollal. Egy folyamat a FreeConsole függvénnyel leválaszthatja magát az aktuális konzolról, majd meghívhatja az AllocConsole-t egy új konzol létrehozásához, vagy az AttachConsole függvényt egy másik konzolhoz való csatoláshoz.

Ha a hívási folyamat létrehoz egy gyerekfolyamatot, a gyerek örökli az új konzolt.

Az AllocConsole inicializálja a standard bemenetet, a standard kimenetet és a standard hibakezelőket az új konzolhoz. A standard bemeneti fogópont a konzol bemeneti pufferének fogópontja, a standard kimeneti és a standard hibafogópontok pedig a konzol képernyőpufferének fogópontjai. A fogantyúk lekéréséhez használja a GetStdHandle függvényt.

Ezt a függvényt elsősorban grafikus felhasználói felület (GUI) alkalmazás használja egy konzolablak létrehozásához. A grafikus felhasználói felület alkalmazásai konzol nélkül inicializálódnak. A konzolalkalmazások inicializálva vannak egy konzollal, kivéve, ha leválasztott folyamatként jönnek létre (a CreateProcess függvény meghívásával a DETACHED_PROCESS jelzővel).

Követelmények

Minimálisan támogatott ügyfél	Windows 2000 Professional [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows 2000 Server [csak asztali alkalmazások]
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

AllocConsoleWithOptions

AttachConsole

CreateProcess

FreeConsole

GetStdHandle