AllocConsole-Funktion

Weist eine neue Konsole für den Aufrufvorgang 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. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

Ein Prozess kann nur einer Konsole zugeordnet werden, 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 von der aktuellen Konsole zu trennen. Anschließend kann allocConsole aufgerufen werden, um eine neue Konsole oder AttachConsole zu erstellen, um eine andere Konsole anzufügen.

Wenn der aufrufenden Prozess einen untergeordneten Prozess erstellt, erbt der untergeordnete Prozess die neue Konsole.

AllocConsole initialisiert Standardeingaben, Standardausgabe und Standardfehlerhandles 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. Verwenden Sie zum Abrufen dieser Handles die GetStdHandle-Funktion .

Diese Funktion wird in erster Linie von einer GUI-Anwendung (Grafische Benutzeroberfläche) verwendet, um ein Konsolenfenster zu erstellen. GUI-Anwendungen werden ohne Konsole initialisiert. Konsolenanwendungen werden mit einer Konsole initialisiert, es sei denn, sie werden als getrennte Prozesse erstellt (durch Aufrufen der CreateProcess-Funktion mit dem flag DETACHED_PROCESS ).

Anforderungen

Mindest unterstützter Client	Windows 2000 Professional [nur Desktop-Apps]
Unterstützter Mindestserver	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	ConsoleApi.h (über WinCon.h, Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Konsolenfunktionen

Consoles

AllocConsoleWithOptions

AttachConsole

CreateProcess

FreeConsole

GetStdHandle