ITfFnSearchCandidateProvider：：GetSearchCandidates 方法 (ctffunc.h)

取得指定字串的轉換候選專案清單，而不產生任何與 IME 相關的訊息或事件。

語法

HRESULT GetSearchCandidates(
  [in]  BSTR             bstrQuery,
  [in]  BSTR             bstrApplicationId,
  [out] ITfCandidateList **pplist
);

[in] bstrQuery

字串，指定文字服務嘗試轉換的讀取字串。

[in] bstrApplicationId

應用程式指定的字串，可讓文字服務根據輸入歷程記錄，選擇性地為不同的應用程式或內容提供不同的候選專案。您可以針對泛型內容傳遞空 的 BSTR L“ ”

[out] pplist

ITfCandidateList，可接收要求的候選數據。

這個方法可以傳回其中一個值。

傳回碼	描述
S_OK	此方法成功。
S_FALSE	輸入字串無法傳回候選專案， pplist 可能是 NULL。