AllocConsole 函式
為呼叫程序配置新的主控台。
BOOL WINAPI AllocConsole(void);
此函式沒有參數。
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
一個程序只能與一個主控台相關聯,因此,如果呼叫程序已經有主控台,AllocConsole 函式就會失敗。 程序可以使用 FreeConsole 函式將其本身從目前的主控台卸離,然後呼叫 AllocConsole 來建立新的主控台,或呼叫 AttachConsole 來連結至另一個主控台。
如果呼叫程序建立了子程序,則子程序會繼承新的主控台。
AllocConsole 會初始化新主控台的標準輸入、標準輸出和標準錯誤控制代碼。 標準輸入控制代碼是主控台輸入緩衝區的控制代碼,而標準輸出和標準錯誤控制代碼則是主控台畫面緩衝區的控制代碼。 若要取得這些控制代碼,請使用 GetStdHandle 函式。
此函式的主要用途是讓圖形使用者介面 (GUI) 應用程式用來建立主控台視窗。 GUI 應用程式會在沒有主控台的情況下進行初始化。 控制台應用程式會使用主控台初始化,除非它們建立為已中斷鏈接的進程(方法是使用 DETACHED_PROCESS 旗標呼叫 CreateProcess 函式)。
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
頁首 | ConsoleApi.h (透過 WinCon.h,包括 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |