SetConsoleActiveScreenBuffer 함수

  • 아티클

Important

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

지정된 화면 버퍼를 현재 표시된 콘솔 화면 버퍼로 설정합니다.

구문

BOOL WINAPI SetConsoleActiveScreenBuffer(
  _In_ HANDLE hConsoleOutput
);

매개 변수

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

반환 값

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

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

설명

콘솔에는 여러 개의 화면 버퍼가 있을 수 있습니다. SetConsoleActiveScreenBuffer 는 표시되는 것을 결정합니다. 비활성 화면 버퍼에 쓴 다음 SetConsoleActiveScreenBuffer를 사용하여 버퍼의 내용을 표시할 수 있습니다.

팁

이 API는 권장되지 않지만 대체 화면 버퍼 시퀀스에 해당하는 대략적인 가상 터미널이 있습니다. 대체 화면 버퍼를 설정하면 애플리케이션의 호출자가 표시한 콘텐츠를 유지하면서 세션 런타임 동안 그리기 위한 별도의 격리된 공간을 애플리케이션에 제공할 수 있습니다. 이 기본 프로세스 종료에서 간단한 복원을 위한 정보를 그리는 것을 확인합니다.

예제

예를 들어 문자 및 특성의 읽기 및 쓰기 블록을 참조 하세요.

요구 사항

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

참고 항목

콘솔 함수

콘솔 화면 버퍼

CreateConsoleScreenBuffer