GetKeyboardLayoutNameA 함수(winuser.h)

아티클
07/21/2023

호출 스레드에 대한 활성 입력 로캘 식별자(이전의 키보드 레이아웃이라고 함)의 이름을 검색합니다.

구문

BOOL GetKeyboardLayoutNameA(
  [out] LPSTR pwszKLID
);

매개 변수

[out] pwszKLID

형식: LPTSTR

종료 null 문자를 포함하여 입력 로캘 식별자의 이름을 수신하는 버퍼(길이가 KL_NAMELENGTH 이상)입니다. 레이아웃 대체가 수행되지 않는 한 LoadKeyboardLayout 함수에 제공된 문자열의 복사본입니다.

Windows와 함께 제공되는 입력 레이아웃 목록은 Windows용 키보드 식별자 및 입력 방법 편집기를 참조하세요.

반환 값

형식: BOOL

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

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

설명

입력 로캘 식별자는 음성 텍스트 변환기, IME(입력 방법 편집기) 또는 다른 형식의 입력을 포함할 수도 있으므로 키보드 레이아웃보다 광범위한 개념입니다.

Windows 8부터: 현재 키보드 레이아웃 또는 입력 메서드와 연결된 언어를 검색하는 기본 방법은 Windows.Globalization.Language.CurrentInputMethodLanguageTag를 호출하는 것입니다. 앱이 CurrentInputMethodLanguageTag 의 언어 태그를 모든 국가 언어 지원 함수로 전달하는 경우 먼저 ResolveLocaleName을 호출하여 태그를 변환해야 합니다.

참고

winuser.h 헤더는 GETKeyboardLayoutName을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll