Fungsi ImmGetCandidateListA (imm.h)
Mengambil daftar kandidat.
Sintaks
DWORD ImmGetCandidateListA(
HIMC unnamedParam1,
[in] DWORD deIndex,
[out, optional] LPCANDIDATELIST lpCandList,
[in] DWORD dwBufLen
);
Parameter
unnamedParam1
[in] deIndex
Indeks berbasis nol dari daftar kandidat.
[out, optional] lpCandList
Arahkan ke struktur CANDIDATELIST tempat fungsi mengambil daftar kandidat.
[in] dwBufLen
Ukuran, dalam byte, dari buffer untuk menerima daftar kandidat. Aplikasi dapat menentukan 0 untuk parameter ini jika fungsinya hanya mengembalikan ukuran buffer output yang diperlukan.
Nilai kembali
Mengembalikan jumlah byte yang disalin ke buffer daftar kandidat jika berhasil. Jika aplikasi telah menyediakan 0 untuk parameter dwBufLen , fungsi mengembalikan ukuran yang diperlukan untuk buffer daftar kandidat.
Fungsi mengembalikan 0 jika tidak berhasil.
Keterangan
Catatan
Header imm.h mendefinisikan ImmGetCandidateList sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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
| Persyaratan | Nilai |
|---|---|
| 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 |