SetConsoleOutputCP 함수

  • 아티클

호출 프로세스와 연결된 콘솔에서 사용하는 출력 코드 페이지를 설정합니다. 콘솔은 출력 코드 페이지를 사용하여 다양한 출력 함수가 작성한 문자 값을 콘솔 창에 표시되는 이미지로 변환합니다.

구문

BOOL WINAPI SetConsoleOutputCP(
  _In_ UINT wCodePageID
);

매개 변수

wCodePageID [in]
설정할 코드 페이지의 식별자입니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

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

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

설명

코드 페이지는 256자 코드를 개별 문자에 매핑합니다. 여러 코드 페이지에는 일반적으로 언어 또는 언어 그룹에 대해 사용자 지정된 여러 특수 문자가 들어 있습니다.

현재 글꼴이 고정 피치 유니코드 글꼴 인 경우 SetConsoleOutputCP 는 문자 값의 매핑을 호출할 때마다 별도의 글꼴을 로드하는 대신 글꼴의 문자 모양 집합으로 변경합니다. 이는 확장 문자(127보다 큰 ASCII 값)가 콘솔 창에 표시되는 방식에 영향을 줍니다. 그러나 현재 글꼴이 래스터 글꼴인 경우 SetConsoleOutputCP 는 확장 문자가 표시되는 방식에 영향을 주지 않습니다.

운영 체제에서 설치하거나 지원하는 코드 페이지를 찾으려면 EnumSystemCodePages 함수를 사용합니다. 로컬 컴퓨터에서 사용할 수 있는 코드 페이지의 식별자도 다음 키 아래 레지스트리에 저장됩니다.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage

그러나 레지스트리가 다른 버전의 Windows에서 다를 수 있으므로 EnumSystemCodePages를 사용하여 코드 페이지를 열거하는 것이 좋습니다. 특정 코드 페이지가 유효한지 확인하려면 IsValidCodePage 함수를 사용합니다. 해당 이름을 포함하여 코드 페이지에 대한 자세한 정보를 검색하려면 GetCPInfoEx 함수를 사용합니다. 사용 가능한 코드 페이지 식별자 목록은 코드 페이지 식별자를 참조 하세요.

콘솔의 현재 출력 코드 페이지를 확인하려면 GetConsoleOutputCP 함수를 사용합니다. 콘솔의 입력 코드 페이지를 설정하고 검색하려면 SetConsoleCP 및 GetConsoleCP 함수를 사용합니다.

요구 사항

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

참고 항목

콘솔 코드 페이지

콘솔 함수

GetConsoleCP

GetConsoleOutputCP

SetConsoleCP