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 name value」 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL。

注意

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


最低支援的用戶端	Windows XP [僅限傳統型應用程式]，已安裝東亞語言支援。
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	imm.h (包括 Immdev.h、Windows.h)
程式庫	Imm32.lib
Dll	Imm32.dll