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

鍵盤輸入

參考