GetLargestConsoleWindowSize 函式
重要
本文件說明已不再是生態系統 藍圖一部分的控制台平臺功能。 我們不建議您在新產品中使用此內容，但我們將繼續支持無限期的未來現有使用量。 我們慣用的新式解決方案著重於 虛擬終端機序列 ，以在跨平臺案例中達到最大相容性。 您可以在傳統 主控台與虛擬終端機 檔中找到此設計決策的詳細資訊。
根據目前的字型和顯示器大小，擷取最大可能控制台視窗的大小。
語法
COORD WINAPI GetLargestConsoleWindowSize(
_In_ HANDLE hConsoleOutput
);
參數
hConsoleOutput [in]
主控台螢幕緩衝區的控點。
傳回值
如果函式成功，則傳回值是 COORD 結構，指定最大可能控制台視窗中字元資料行 （X 成員） 和資料列 （Y 成員） 的數目。 否則，結構的成員為零。
若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
函式不會考慮主控台畫面緩衝區的大小，這表示傳回的視窗大小可能大於控制台畫面緩衝區的大小。 GetConsoleScreenBufferInfo 函式可用來判斷主控台視窗的大小上限，因為目前的螢幕緩衝區大小、目前的字型和顯示大小。
提示
不建議使用此 API，而且沒有 虛擬終端機 對等專案。 此決策會刻意將 Windows 平臺與其他操作系統一致，而該操作系統會授與使用者對此簡報選項的完整控制權。 透過跨平臺公用程式和 SSH 之類的傳輸進行遠端處理的應用程式在使用這個 API 時可能無法如預期般運作。
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 頁首 | ConsoleApi2.h （透過 WinCon.h，包含 Windows.h） |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |