共用方式為

ImmGetCandidateListA 函式 (imm.h)

  • 發行項

擷取候選清單。

語法

DWORD ImmGetCandidateListA(
                  HIMC            unnamedParam1,
  [in]            DWORD           deIndex,
  [out, optional] LPCANDIDATELIST lpCandList,
  [in]            DWORD           dwBufLen
);

參數

unnamedParam1

[in] deIndex

候選清單以零起始的索引。

[out, optional] lpCandList

FUNCTION 擷取候選清單之 CANDIDATELIST 結構的指標。

[in] dwBufLen

要接收候選清單的緩衝區大小，以位元組為單位。 如果函式只傳回所需的輸出緩衝區大小，應用程式可以指定此參數的 0。

傳回值

如果成功，會傳回復制到候選清單緩衝區的位元元組數目。 如果應用程式已為 dwBufLen 參數提供 0，函式會傳回候選清單緩衝區所需的大小。

如果函式不成功，函式會傳回 0。

備註

注意

imm.h 標頭會將 ImmGetCandidateList 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]，已安裝東亞語言支援。
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 imm.h (包括 Immdev.h、Windows.h)
程式庫 Imm32.lib
Dll Imm32.dll

另請參閱

CANDIDATELIST

輸入方法管理員

輸入方法管理員函式