AllocConsole-Funktion

Artikel
07/12/2023

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