AllocConsole – funkce

Přiřadí novou konzoli pro volající proces.

Syntaxe

BOOL WINAPI AllocConsole(void);

Parametry

Tato funkce nemá žádné parametry.

Návratová hodnota

Pokud je funkce úspěšná, je návratová hodnota nenulová.

Pokud funkce selže, návratová hodnota je nula. Pokud chcete získat rozšířené informace o chybě, zavolejte GetLastError.

Poznámky

Proces může být přidružený pouze k jedné konzole, takže funkce AllocConsole selže, pokud volající proces již má konzolu. Proces může použít funkci FreeConsole k odpojení od aktuální konzoly a pak může volat AllocConsole k vytvoření nové konzoly nebo AttachConsole pro připojení k jiné konzole.

Pokud volající proces vytvoří podřízený proces, tento zdědí novou konzolu.

Funkce AllocConsole inicializuje standardní vstup, standardní výstup a standardní popisovače chyb pro novou konzolu. Standardní vstupní popisovač je popisovač vstupní vyrovnávací paměti konzole a standardní výstupní a standardní chybové popisovače jsou popisovače vyrovnávací paměti obrazovky konzole. K načtení těchto popisovačů použijte funkci GetStdHandle.

Tuto funkci primárně používá aplikace grafického uživatelského rozhraní (GUI) k vytvoření okna konzoly. Aplikace grafického uživatelského rozhraní se inicializují bez konzoly. Konzolové aplikace se inicializují pomocí konzoly, pokud nejsou vytvořeny jako odpojené procesy (voláním funkce CreateProcess s příznakem DETACHED_PROCESS ).

Požadavky

Minimální podporovaný klient	Windows 2000 Professional [jenom desktopové aplikace]
Minimální podporovaný server	Windows 2000 Server [jenom desktopové aplikace]
Záhlaví	ConsoleApi.h (přes WinCon.h, včetně Windows.h)
Knihovna	Kernel32.lib
knihovna DLL	Kernel32.dll

Viz také

Funkce konzoly

konzoly

AllocConsoleWithOptions

AttachConsole

CreateProcess

FreeConsole

GetStdHandle