Not
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Allokerar en ny konsol för samtalsprocessen.
Syntax
BOOL WINAPI AllocConsole(void);
Parameterar
Den här funktionen har inga parametrar.
Returvärde
Om funktionen lyckas är returvärdet icke-noll.
Om funktionen misslyckas är returvärdet noll. Om du vill få utökad felinformation anropar du GetLastError.
Anmärkningar
En process kan bara associeras med en konsol, så funktionen AllocConsole misslyckas om anropsprocessen redan har en konsol. En process kan använda funktionen FreeConsole för att koppla från sig själv från den aktuella konsolen. Sedan kan den anropa AllocConsole för att skapa en ny konsol eller AttachConsole för att ansluta till en annan konsol.
Om anropsprocessen skapar en underordnad process ärver barnet den nya konsolen.
AllocConsole initierar standardindata, standardutdata och standardfelhandtag för den nya konsolen. Standardindatahandtaget är ett handtag till konsolens indatabuffert, och standardutdata- och standardfelhandtagen är handtag till konsolens skärmbuffert. Om du vill hämta dessa handtag använder funktionen GetStdHandle.
Den här funktionen används främst av ett grafiskt användargränssnittsprogram (GUI) för att skapa ett konsolfönster. GUI-program initieras utan en konsol. Konsolprogram initieras med en konsol, såvida de inte skapas som fristående processer (genom att anropa funktionen CreateProcess med flaggan DETACHED_PROCESS ).
Kravspecifikation
| Lägsta klient som stöds | Windows 2000 Professional [endast skrivbordsappar] |
| Lägsta server som stöds | Windows 2000 Server [endast skrivbordsappar] |
| Rubrik | ConsoleApi.h (via WinCon.h, inkludera Windows.h) |
| Bibliotek | Kernel32.lib |
| DLL | Kernel32.dll |