ITfFnSearchCandidateProvider::SetResult メソッド (ctffunc.h)

ユーザーが候補を選択したときに、履歴データを含むテキスト Service または IME を提供します。

構文

HRESULT SetResult(
  [in] BSTR bstrQuery,
  [in] BSTR bstrApplicationID,
  [in] BSTR bstrResult
);

[in] bstrQuery

変換するテキストサービスまたは IME の読み取り文字列。

[in] bstrApplicationID

テキストサービスまたは IME が必要に応じて、入力履歴に基づいて異なるアプリまたはコンテキストに異なる候補を提供できるようにする、アプリ指定の文字列。ジェネリックコンテキストには、空の BSTR L"" を渡すことができます。

[in] bstrResult

ユーザーが選択した候補文字列を表す文字列。 GetSearchCandidates メソッドによって返される候補の文字列値のいずれかである必要があります。

このメソッドは、これらの値のいずれかを返すことができます。

値	説明
S_OK	メソッドは正常に実行されました。

SetResult メソッドの実装と呼び出しは省略可能です。

bstrQuery の値に対応する GetSearchCandidates の呼び出しがまだ行われていない場合、テキストサービスまたは IME はE_PENDINGを返すことができます。