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 |