FreeConsole-Funktion

Artikel
12/21/2023

Trennt den Aufrufvorgang von der Konsole.

Syntax

BOOL WINAPI FreeConsole(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 zumindest an eine Konsole angefügt werden. Ein Prozess kann die FreeConsole-Funktion verwenden, um sich von der Konsole zu trennen. Wenn andere Prozesse die Konsole freigeben, wird die Konsole nicht zerstört, aber der Prozess, der als FreeConsole bezeichnet wird, kann nicht darauf verweisen. Eine Konsole wird geschlossen, wenn der letzte an sie angefügte Prozess beendet oder FreeConsole aufruft. Nachdem ein Prozess FreeConsole abruft, kann es die AllocConsole Funktion aufrufen, um eine neue Konsole oder AttachConsole zu erschaffen, um eine andere Konsole anzufügen. Wenn der Aufrufvorgang noch nicht an eine Konsole angefügt ist, ist die FreeConsole-Anforderung weiterhin erfolgreich.

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

Siehe auch