SetConsoleScreenBufferInfoEx 함수

  • 아티클

Important

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

지정된 콘솔 화면 버퍼에 대한 확장 정보를 설정합니다.

구문

BOOL WINAPI SetConsoleScreenBufferInfoEx(
  _In_ HANDLE                        hConsoleOutput,
  _In_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);

매개 변수

hConsoleOutput [in]
콘솔 화면 버퍼에 대한 핸들입니다. 핸들에는 GENERIC_WRITE 액세스 권한이 있어야 합니다. 자세한 내용은 콘솔 버퍼 보안 및 액세스 권한을 참조하세요.

lpConsoleScreenBufferInfoEx [in]
콘솔 화면 버퍼 정보를 포함하는 CONSOLE_SCREEN_BUFFER_INFOEX 구조체입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

팁

이 API에는 해당하는 부분 가상 터미널이 있습니다. 커서 위치 지정 버퍼 및 텍스트 특성 에는 해당하는 특정 시퀀스가 있습니다. 색 테이블은 구성할 수 없지만 확장된 색은 콘솔 함수를 통해 일반적으로 사용할 수 있는 색을 초과하여 사용할 수 있습니다. 팝업 특성은 가상 터미널 세계에서 명령줄 클라이언트 애플리케이션의 책임이 팝업 메뉴와 동일하지 않습니다. 마지막으로, 창의 크기와 전체 화면 상태 가상 터미널 세계에서 사용자가 소유한 권한으로 간주되며 동등한 시퀀스가 없습니다.

요구 사항

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

참고 항목

콘솔 함수

CONSOLE_SCREEN_BUFFER_INFOEX

GetConsoleScreenBufferInfoEx