getKeyboardLayoutList 函式 (winuser.h)

擷取先前稱為鍵盤配置控制碼 (輸入地區設定識別碼,) 對應至系統中目前的輸入地區設定集。 函式會將識別碼複製到指定的緩衝區。

語法

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

參數

[in] nBuff

類型: int

緩衝區可以保存的最大控制碼數目。

[out] lpList

類型: HKL*

接收輸入地區設定識別碼陣列之緩衝區的指標。

傳回值

類型: int

如果函式成功,則傳回值是複製到緩衝區的輸入地區設定識別碼數目,如果 nBuff 為零,則傳回值會是接收所有目前輸入地區設定識別碼所需的緩衝區大小。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

輸入地區設定識別碼是比鍵盤配置更廣泛的概念,因為它也可以包含語音轉換文字轉換器、輸入法編輯器 (輸入法) 或任何其他形式的輸入。

從Windows 8開始:擷取與目前鍵盤配置或輸入法相關聯的語言慣用方法是呼叫Windows.Globalization.Language.CurrentInputMethodLanguageTag。 如果您的應用程式將語言標籤從 CurrentInputMethodLanguageTag 傳遞至任何 國家語言支援 函式,則必須先呼叫 ResolveLocaleName來轉換標記。

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平臺 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
DLL User32.dll

另請參閱

概念

GetKeyboardLayout

鍵盤輸入

參考