다음을 통해 공유

GetKeyboardLayoutNameW 함수(winuser.h)

  • 아티클

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

통사론

BOOL GetKeyboardLayoutNameW(
  [out] LPWSTR 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

참고 항목

ActivateKeyboardLayout

개념

키보드 입력

LoadKeyboardLayout

참조

UnloadKeyboardLayout