FreeConsole-Funktion
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 |