GetKeyboardLayoutList 함수(winuser.h)

시스템의 현재 입력 로캘 집합에 해당하는 입력 로캘 식별자(이전의 키보드 레이아웃 핸들)를 가져옵니다. 함수는 식별자를 지정된 버퍼에 복사합니다.

구문

int GetKeyboardLayoutList(
  [in]  int nBuff,
  [out] HKL *lpList
);

[in] nBuff

형식: int

버퍼가 보유할 수 있는 최대 핸들 수입니다.

[out] lpList

형식: HKL*

입력 로캘 식별자의 배열을 수신하는 버퍼에 대한 포인터입니다.

형식: int

함수가 성공하면 반환 값은 버퍼에 복사된 입력 로캘 식별자의 수이거나 nBuff 가 0이면 반환 값은 현재 입력 로캘 식별자를 모두 수신하는 데 필요한 버퍼의 크기(배열 요소)입니다.

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

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

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


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

개념

참조