ImmGetIMEFileNameA 関数 (immdev.h)

  • [アーティクル]

指定した入力ロケールに関連付けられている IME のファイル名を取得します。

構文

UINT ImmGetIMEFileNameA(
                  HKL   unnamedParam1,
  [out, optional] LPSTR lpszFileName,
  [in]            UINT  uBufLen
);

パラメーター

unnamedParam1

[out, optional] lpszFileName

関数がファイル名を取得するバッファーへのポインター。 uBufLen が NULL に設定されている場合、このパラメーターには NULL が含まれます。

[in] uBufLen

出力バッファーのサイズ (バイト単位)。 アプリケーションは、関数がファイル名を受け取るために必要なバッファー サイズを返す場合は 0 を指定します。終端の null 文字は含まれません。 Unicode の場合、 uBufLen は Unicode 文字でサイズを指定します。終端の null 文字は含まれません。

戻り値

出力バッファーにコピーされたファイル名のバイト数を返します。 アプリケーションで uBufLen を 0 に設定すると、関数はファイル名に必要なバッファーのサイズを返します。 どちらの場合も、終端の null 文字は含まれません。

Unicode の場合、関数は出力バッファーにコピーされた Unicode 文字の数を返します。Unicode 終端の null 文字は含まれません。

解説

レジストリでは、オペレーティング システムはファイル名をレジストリ キー HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL の "IME 名の値" として格納します。

Note

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

要件

   
サポートされている最小のクライアント Windows XP [デスクトップ アプリのみ]、東アジア言語のサポートがインストールされています。
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー immdev.h (Immdev.h、Windows.h を含む)
Library Imm32.lib
[DLL] Imm32.dll

関連項目

入力メソッド マネージャー

入力メソッド マネージャー関数