Bagikan melalui


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