GetConsoleAliasesLength 함수

아티클
10/23/2023

Important

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

GetConsoleAliases 함수에서 사용하는 버퍼에 필요한 크기를 검색합니다 .

구문

DWORD WINAPI GetConsoleAliasesLength(
  _In_ LPTSTR lpExeName
);

매개 변수

lpExeName [in]
콘솔 별칭을 검색할 실행 파일의 이름입니다.

반환 값

이 실행 파일에 대해 정의된 모든 콘솔 별칭을 저장하는 데 필요한 버퍼의 크기(바이트)입니다.

설명

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0501 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조 하세요.

팁

이 API는 권장되지 않으며 해당하는 가상 터미널이 없습니다. 이 결정은 의도적으로 Windows 플랫폼을 셸 또는 인터프리터 역할을 하는 개별 클라이언트 애플리케이션이 별칭 및 명령 기록을 포함한 줄 읽기 및 조작 동작과 같은 고유한 사용자 편의 기능을 기본 것으로 예상되는 다른 운영 체제와 일치합니다. 이 API를 사용하는 경우 플랫폼 간 유틸리티 및 SSH와 같은 전송을 통한 애플리케이션 원격 작업이 예상대로 작동하지 않을 수 있습니다.

요구 사항


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