GetConsoleOriginalTitle 함수
Important
이 문서에서는 더 이상 에코시스템 로드맵의 일부가 되지 않는 콘솔 플랫폼 기능에 대해 설명합니다. 이 콘텐츠를 신제품에서 사용하지 않는 것이 좋지만, 무기한 앞으로도 기존 사용을 계속 지원할 것입니다. 선호하는 최신 솔루션은 플랫폼 간 시나리오에서 최대 호환성을 위해 가상 터미널 시퀀스에 중점을 둡니다. 이 디자인 결정에 대한 자세한 내용은 클래식 콘솔과 가상 터미널 문서에서 확인할 수 있습니다.
현재 콘솔 창의 원래 제목을 검색합니다.
구문
DWORD WINAPI GetConsoleOriginalTitle(
_Out_ LPTSTR lpConsoleTitle,
_In_ DWORD nSize
);
매개 변수
lpConsoleTitle [out]
원래 제목을 포함하는 null로 끝나는 문자열을 수신하는 버퍼에 대한 포인터입니다.
nSize [in]
lpConsoleTitle 버퍼의 크기(문자)입니다 .
반환 값
nSize가 0이면 반환 값은 0입니다.
함수가 성공하면 반환 값은 원래 콘솔 타이틀의 길이(문자)입니다.
함수가 실패하면 반환 값은 0이고 GetLastError 는 오류 코드를 반환합니다.
설명
콘솔 창의 제목을 설정하려면 SetConsoleTitle 함수를 사용합니다. 현재 제목 문자열을 검색하려면 GetConsoleTitle 함수를 사용합니다.
이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0600 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조 하세요.
팁
이 API는 권장되지 않으며 해당하는 가상 터미널이 없습니다. 이 결정은 의도적으로 Windows 플랫폼을 다른 운영 체제와 정렬합니다. 이 API를 사용하는 경우 플랫폼 간 유틸리티 및 SSH와 같은 전송을 통한 애플리케이션 원격 작업이 예상대로 작동하지 않을 수 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 | ConsoleApi2.h(WinCon.h를 통해 Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |
| 유니코드 및 ANSI 이름 | GetConsoleOriginalTitleW (유니코드) 및 GetConsoleOriginalTitleA (ANSI) |