Fungsi ImmGetIMEFileNameA (imm.h)

Mengambil nama file IME yang terkait dengan lokal input yang ditentukan.

Sintaks

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

Parameter

unnamedParam1

[out, optional] lpszFileName

Penunjuk ke buffer tempat fungsi mengambil nama file. Parameter ini berisi NULL ketika uBufLen diatur ke NULL.

[in] uBufLen

Ukuran, dalam byte, dari buffer output. Aplikasi menentukan 0 jika fungsinya adalah mengembalikan ukuran buffer yang diperlukan untuk menerima nama file, tidak termasuk karakter null yang mengakhiri. Untuk Unicode, uBufLen menentukan ukuran dalam karakter Unicode, tidak termasuk karakter null yang mengakhiri.

Mengembalikan nilai

Mengembalikan jumlah byte dalam nama file yang disalin ke buffer output. Jika aplikasi mengatur uBufLen ke 0, fungsi mengembalikan ukuran buffer yang diperlukan untuk nama file. Dalam kedua kasus, karakter null yang mengakhiri tidak disertakan.

Untuk Unicode, fungsi mengembalikan jumlah karakter Unicode yang disalin ke dalam buffer output, tidak termasuk karakter null penghentian Unicode.

Keterangan

Dalam registri, sistem operasi menyimpan nama file sebagai "nilai nama IME" dalam kunci registri HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL.

Catatan

Header imm.h mendefinisikan ImmGetIMEFileName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop],dukungan bahasa Asia Timur terinstal.
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	imm.h (termasuk Immdev.h, Windows.h)
Pustaka	Imm32.lib
DLL	Imm32.dll

Lihat juga

Manajer Metode Input

Fungsi Manajer Metode Input