WriteConsoleOutputAttribute 함수

아티클
12/13/2023

Important

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

지정된 위치에서 시작하여 콘솔 화면 버퍼의 연속 셀에 여러 문자 특성을 복사합니다.

구문

BOOL WINAPI WriteConsoleOutputAttribute(
  _In_        HANDLE  hConsoleOutput,
  _In_  const WORD    *lpAttribute,
  _In_        DWORD   nLength,
  _In_        COORD   dwWriteCoord,
  _Out_       LPDWORD lpNumberOfAttrsWritten
);

매개 변수

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

lpAttribute [in]
콘솔 화면 버퍼에 쓸 때 사용할 특성입니다. 자세한 내용은 문자 특성을 참조 하세요.

nLength [in]
특성을 복사할 화면 버퍼 문자 셀의 수입니다.

dwWriteCoord [in]
특성을 쓸 콘솔 화면 버퍼에서 첫 번째 셀의 문자 좌표를 지정하는 COORD 구조체입니다.

lpNumberOfAttrsWritten [out]
콘솔 화면 버퍼에 실제로 기록된 특성 수를 받는 변수에 대한 포인터입니다.

반환 값

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

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

설명

작성할 특성 수가 콘솔 화면 버퍼에서 지정된 행의 끝을 넘어 확장되면 특성이 다음 행에 기록됩니다. 작성할 특성 수가 콘솔 화면 버퍼의 끝을 넘어 확장되는 경우 특성은 콘솔 화면 버퍼의 끝까지 기록됩니다.

기록된 위치의 문자 값은 변경되지 않습니다.

팁

이 API에는 텍스트 서식 및 커서 위치 지정 시퀀스에 해당하는 가상 터미널이 있습니다. 커서를 삽입할 위치로 이동하고 원하는 서식을 적용한 다음 채울 텍스트를 작성합니다. 텍스트를 내보내지 않고 영역에 색을 적용하는 것과 동일한 항목은 없습니다. 이 결정은 개별 클라이언트 애플리케이션이 추가 조작을 위해 자체 그리기 상태를 기억해야 하는 다른 운영 체제와 Windows 플랫폼을 의도적으로 정렬합니다.

요구 사항


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