SetConsoleTextAttribute 함수

Important

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

WriteFile 또는 WriteConsole 함수에 의해 콘솔 화면 버퍼에 기록되거나 ReadFile 또는 ReadConsole 함수에 의해 에코되는 문자의 특성을 설정합니다. 이 함수는 함수 호출 후에 작성된 텍스트에 영향을 줍니다.

구문

BOOL WINAPI SetConsoleTextAttribute(
  _In_ HANDLE hConsoleOutput,
  _In_ WORD   wAttributes
);

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

wAttributes [in]
문자 특성입니다.

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

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

화면 버퍼의 현재 색 특성을 확인하려면 GetConsoleScreenBufferInfo 함수를 호출합니다.

팁

이 API에는 텍스트 서식 시퀀스에 해당하는 가상 터미널이 있습니다. 가상 터미널 시퀀스는 모든 신규 개발 및 진행 중인 개발에 권장됩니다.

예를 들어 상위 수준 입력 및 출력 함수 사용을 참조 하세요.


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