immGetConversionListA 函式 (imm.h)
擷取字元或單字的轉換結果清單,而不產生任何與 IME 相關的訊息。
語法
DWORD ImmGetConversionListA(
HKL unnamedParam1,
HIMC unnamedParam2,
[in] LPCSTR lpSrc,
[out] LPCANDIDATELIST lpDst,
[in] DWORD dwBufLen,
[in] UINT uFlag
);
參數
unnamedParam1
unnamedParam2
[in] lpSrc
指定清單來源之 Null 終止字元字串的指標。
[out] lpDst
FUNCTION 擷取清單之 CANDIDATELIST 結構的指標。
[in] dwBufLen
輸出緩衝區的大小,以位元組為單位。 如果函式傳回完整轉換結果清單所需的緩衝區大小,則應用程式會將此參數設定為 0。
[in] uFlag
動作旗標。 此參數可以有下列其中一個值。
值 | 意義 |
---|---|
|
來源字串是讀取字串。 函式會將結果字串複製到目的地緩衝區。 |
|
來源字串是結果字串。 函式會將讀取字串複製到目的地緩衝區。 |
|
來源字串是結果字串。 如果指定GCL_REVERSECONVERSION,函式會傳回讀取字串的大小,以位元組為單位。 |
傳回值
傳回復制到輸出緩衝區的位元組數目。 如果應用程式將 dwBufLen 參數設定為 0,函式會傳回所需輸出緩衝區的大小,以位元組為單位。
備註
注意
imm.h 標頭會將 ImmGetConversionList 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
需求
最低支援的用戶端 | Windows XP [僅限傳統型應用程式],已安裝東亞語言支援。 |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | imm.h (包括 Immdev.h、Windows.h) |
程式庫 | Imm32.lib |
Dll | Imm32.dll |