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

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 ctffunc.h

另请参阅

ITfFnSearchCandidateProvider

SearchPaneQueryLinguisticDetails

SetResult