GetKeyboardLayoutNameA 関数 (winuser.h)

呼び出し元スレッドのアクティブな入力ロケール識別子 (以前はキーボード レイアウトと呼ばれる) の名前を取得します。

構文

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 を呼び出してタグを変換する必要があります。

Note

winuser.h ヘッダーは、GetKeyboardLayoutName をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll

関連項目

ActivateKeyboardLayout

概念

キーボード入力

LoadKeyboardLayout

参照

UnloadKeyboardLayout