ImmGetIMEFileNameA 函式（imm.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 字元。

在登錄中，作業系統會將檔案名儲存為登錄機碼中的「IME 名稱值」，HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL。

注意

imm.h 標頭會根據 UNICODE 預處理器常數的定義，將 ImmGetIMEFileName 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]，已安裝東亞語言支援。
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	imm.h （包括 Immdev.h、Windows.h）
連結庫	Imm32.lib
DLL	Imm32.dll