FreeConsole 函式

從其控制台中斷呼叫進程。

語法

BOOL WINAPI FreeConsole(void);

參數

此函式沒有參數。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

進程最多可以連結至一個控制台。 進程可以使用 FreeConsole 函式，將本身與其控制台中斷連結。 如果其他進程共用控制台，則不會終結控制台，但稱為 FreeConsole 的進程無法參考它。 當附加至主控台的最後一個進程終止或呼叫 FreeConsole時，主控台就會關閉。 進程呼叫 FreeConsole 之後，它可以呼叫 AllocConsole 函式來建立新的控制台或 AttachConsole 以附加至另一個控制台。 如果呼叫程式尚未附加至主控台， FreeConsole 要求仍會成功。

需求

最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
頁首	ConsoleApi.h (透過 WinCon.h，包括 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

AllocConsole

AttachConsole

主控台函式

主控台