AllocConsole-Funktion
Ordnet eine neue Konsole für den aufrufenden Prozess zu.
Syntax
BOOL WINAPI AllocConsole(void);
Parameter
Diese Funktion besitzt keine Parameter.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Ein Prozess kann nur einer Konsole zugeordnet sein, sodass die AllocConsole-Funktion fehlschlägt, wenn der aufrufende Prozess bereits über eine Konsole verfügt. Ein Prozess kann die FreeConsole-Funktion verwenden, um sich selbst von seiner aktuellen Konsole zu trennen. Anschließend kann er dann AllocConsole aufrufen, um eine neue Konsole zu erstellen, oder AttachConsole, um eine andere Konsole anzufügen.
Wenn der aufrufenden Prozess einen untergeordneten Prozess erstellt, erbt der untergeordnete Prozess die neue Konsole.
AllocConsole initialisiert die Standardhandles für Eingabe, Ausgabe und Fehler für die neue Konsole. Das Standardeingabehandle ist ein Handle für den Eingabepuffer der Konsole, und die Standardausgabe- und Standardfehlerhandles sind Handles für den Bildschirmpuffer der Konsole. Um diese Handles abzurufen, verwenden Sie die Funktion GetStdHandle.
Diese Funktion wird hauptsächlich von einer grafischen Benutzeroberflächenanwendung (GUI) zum Erstellen eines Konsolenfensters verwendet. GUI-Anwendungen werden ohne eine-Konsole initialisiert. Konsolenanwendungen werden mit einer Konsole initialisiert, es sei denn, sie werden als getrennte Prozesse erstellt (durch Aufrufen der CreateProcess-Funktion mit dem DETACHED_PROCESS-Flag).
Anforderungen
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Header | ConsoleApi.h (über WinCon.h, Windows.h einschließen) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |