FreeConsole 函数

从其控制台分离调用进程。

语法

BOOL WINAPI FreeConsole(void);

参数

此函数没有参数。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

备注

一个进程最多可以附加到一个控制台。 进程可以使用 FreeConsole 函数从其控制台分离出来。 如果其他进程共享该控制台，则不会销毁控制台，但调用 FreeConsole 的进程无法引用它。 当附加到控制台的最后一个进程终止或调用 FreeConsole 时，控制台将关闭。 进程调用 FreeConsole 后，可以调用 AllocConsole 函数以创建新控制台，或调用 AttachConsole 以附加到另一个控制台。 如果调用进程尚未附加到控制台，则 FreeConsole 请求仍然成功。

要求

最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	ConsoleApi.h (via WinCon.h, include Windows.h)
库	Kernel32.lib
DLL	Kernel32.dll

另请参阅

AllocConsole

AttachConsole

控制台函数

控制台