GetConsoleTitle 함수

아티클
10/23/2023

Important

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

현재 콘솔 창의 제목을 검색합니다.

구문

DWORD WINAPI GetConsoleTitle(
  _Out_ LPTSTR lpConsoleTitle,
  _In_  DWORD  nSize
);

매개 변수

lpConsoleTitle [out]
제목을 포함하는 null로 끝나는 문자열을 수신하는 버퍼에 대한 포인터입니다. 버퍼가 너무 작아서 제목을 저장할 수 없는 경우 함수는 버퍼에 맞는 만큼 타이틀의 문자를 저장하고 null 종결자로 끝납니다.

nSize [in]
lpConsoleTitle 매개 변수가 가리키는 버퍼의 크기(문자)입니다 .

반환 값

함수가 성공하면 반환 값은 콘솔 창의 제목 길이(문자)입니다.

함수가 실패하면 반환 값은 0이고 GetLastError 는 오류 코드를 반환합니다.

설명

콘솔 창의 제목을 설정하려면 SetConsoleTitle 함수를 사용합니다. 원래 제목 문자열을 검색하려면 GetConsoleOriginalTitle 함수를 사용합니다.

이 함수는 콘솔의 현재 코드 페이지에서 유니코드 문자 또는 8비트 문자를 사용합니다. 콘솔의 코드 페이지는 처음에 기본적으로 시스템의 OEM 코드 페이지로 설정됩니다. 콘솔의 코드 페이지를 변경하려면 SetConsoleCP 또는 SetConsoleOutputCP 함수를 사용합니다. 레거시 소비자는 chcp 또는 mode con cp select= 명령을 사용할 수도 있지만 새로운 개발에는 추천되지 않습니다.

팁

이 API는 권장되지 않으며 해당하는 가상 터미널이 없습니다. 이 결정은 의도적으로 Windows 플랫폼을 다른 운영 체제와 정렬합니다. 이 API를 사용하는 경우 플랫폼 간 유틸리티 및 SSH와 같은 전송을 통한 애플리케이션 원격 작업이 예상대로 작동하지 않을 수 있습니다.

예제

예제는 SetConsoleTitle을 참조 하세요.

요구 사항


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