GetLargestConsoleWindowSize 함수

  • 아티클

Important

이 문서에서는 더 이상 에코시스템 로드맵의 일부가 되지 않는 콘솔 플랫폼 기능에 대해 설명합니다. 이 콘텐츠를 신제품에서 사용하지 않는 것이 좋지만, 무기한 앞으로도 기존 사용을 계속 지원할 것입니다. 선호하는 최신 솔루션은 플랫폼 간 시나리오에서 최대 호환성을 위해 가상 터미널 시퀀스에 중점을 둡니다. 이 디자인 결정에 대한 자세한 내용은 클래식 콘솔과 가상 터미널 문서에서 확인할 수 있습니다.

현재 글꼴 및 디스플레이 크기에 따라 가능한 가장 큰 콘솔 창의 크기를 검색합니다.

구문

COORD WINAPI GetLargestConsoleWindowSize(
  _In_ HANDLE hConsoleOutput
);

매개 변수

hConsoleOutput [in]
콘솔 화면 버퍼에 대한 핸들입니다.

반환 값

함수가 성공하면 반환 값은 가능한 가장 큰 콘솔 창에서 문자 셀 열(X 멤버) 및 행(Y 멤버)의 수를 지정하는 COORD 구조체입니다. 그렇지 않으면 구조체의 멤버가 0입니다.

확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수는 콘솔 화면 버퍼의 크기를 고려하지 않습니다. 즉, 반환된 창 크기가 콘솔 화면 버퍼의 크기보다 클 수 있습니다. GetConsoleScreenBufferInfo 함수를 사용하여 현재 화면 버퍼 크기, 현재 글꼴 및 표시 크기를 고려하여 콘솔 창의 최대 크기를 결정할 수 있습니다.

팁

이 API는 권장되지 않으며 해당하는 가상 터미널이 없습니다. 이 결정은 사용자가 이 프레젠테이션 옵션을 완전히 제어할 수 있는 다른 운영 체제와 Windows 플랫폼을 의도적으로 조정합니다. 이 API를 사용하는 경우 플랫폼 간 유틸리티 및 SSH와 같은 전송을 통한 애플리케이션 원격 작업이 예상대로 작동하지 않을 수 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
헤더 ConsoleApi2.h(WinCon.h를 통해 Windows.h 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

콘솔 함수

COORD

GetConsoleScreenBufferInfo

SetConsoleWindowInfo

창 및 화면 버퍼 크기