AllocConsole-functie

Wijst een nieuwe console toe aan het aanroepende proces.

Syntaxis

BOOL WINAPI AllocConsole(void);

Parameterwaarden

Deze functie heeft geen parameters.

Retourwaarde

Als de functie slaagt, is de retourwaarde niet-nul.

Als de functie mislukt, is de retourwaarde nul. Als u uitgebreide foutinformatie wilt ophalen, roept u GetLastError aan.

Opmerkingen

Een proces kan slechts aan één console worden gekoppeld, zodat de functie AllocConsole mislukt als het aanroepende proces al een console heeft. Een proces kan de functie FreeConsole gebruiken om zichzelf los te koppelen van de huidige console, waarna AllocConsole kan worden aangeroepen om een nieuwe console te maken of AttachConsole te koppelen aan een andere console.

Als het aanroepende proces een subproces maakt, neemt het subproces de nieuwe console over.

AllocConsole initialiseert standaardinvoer, standaarduitvoer en standaardfoutgrepen voor de nieuwe console. De standaardinvoergreep is een ingang voor de invoerbuffer van de console en de standaarduitvoer en standaardfoutgrepen zijn ingangen voor de schermbuffer van de console. Gebruik de functie GetStdHandle om deze handles op te halen.

Deze functie wordt voornamelijk gebruikt door een grafische gebruikersinterfacetoepassing (GUI) om een consolevenster te maken. GUI-toepassingen worden geïnitialiseerd zonder een console. Consoletoepassingen worden geïnitialiseerd met een console, tenzij ze worden gemaakt als losgekoppelde processen (door de functie CreateProcess aan te roepen met de vlag DETACHED_PROCESS ).

Behoeften

Minimaal ondersteunde client	Windows 2000 Professional [alleen desktop-apps]
Minimaal ondersteunde server	Windows 2000 Server [alleen desktop-apps]
Koptekst	ConsoleApi.h (via WinCon.h, inclusief Windows.h)
Bibliotheek	Kernel32.lib
DLL	Kernel32.dll

Zie ook

Consolefuncties

Consoles

AllocConsoleWithOptions

AttachConsole

CreateProcess-

FreeConsole

GetStdHandle