UnloadKeyboardLayout 関数 (winuser.h)

入力ロケール識別子 (以前はキーボード レイアウトと呼ばれていました) をアンロードします。

構文

BOOL UnloadKeyboardLayout(
  [in] HKL hkl
);

パラメーター

[in] hkl

種類: HKL

アンロードする入力ロケール識別子。

戻り値

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 関数は、次の理由で失敗する可能性があります。

  • 無効な入力ロケール識別子が渡されました。
  • 入力ロケール識別子が事前に読み込まれた。
  • 入力ロケール識別子が使用されています。
詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

入力ロケール識別子は、音声テキスト変換コンバーター、入力メソッド エディター (IME)、またはその他の形式の入力も含めることができるため、キーボード レイアウトよりも広範な概念です。

UnloadKeyboardLayout は、読み込まれた唯一のキーボード レイアウトである場合、システムの既定の入力ロケール識別子をアンロードできません。 既定の入力ロケール識別子をアンロードする前に、最初に別の入力ロケール識別子を読み込む必要があります。

要件

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

関連項目

ActivateKeyboardLayout

概念

GetKeyboardLayoutName

キーボード入力

LoadKeyboardLayout

参照