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 |