IPhraseSink

COM

IIDcc906ff0-c058-101a-b554-08002b33b0e6継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

クエリ時にワードブレーカーがクエリテキストから解析したフレーズを処理します。

解説(Remarks)

Indexing Service は PhraseSink オブジェクトのインスタンスを作成して初期化します。PhraseSink は初期化時に fQuery パラメーターを受け取り、このパラメーターを使用して、オブジェクトがどのワードブレークコンテキストで使用されているかを判断します。

IWordBreaker の実装は、BreakText メソッドで PhraseSink オブジェクトへのポインターを受け取ります。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT PutSmallPhrase(LPWSTR pwcNoun, DWORD cwcNoun, LPWSTR pwcModifier, DWORD cwcModifier, DWORD ulAttachmentType)

WordBreaker 向けに、クエリ時の小さなフレーズを IPhraseSink オブジェクトに格納します。

pwcNoun	LPWSTR	in	修飾対象の単語を格納したバッファーへのポインター。
cwcNoun	DWORD	in	pwcNoun の文字数。クエリ時のフレーズのサイズに制限はありません。
pwcModifier	LPWSTR	in	pwcNoun を修飾する単語へのポインター。
cwcModifier	DWORD	in	pwcModifier の文字数。クエリ時のフレーズのサイズに制限はありません。
ulAttachmentType	DWORD	in	ワードブレーカー固有の値。ワードブレーカーは、この値を使用して合成方法に関する追加情報を格納できます。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

PutSmallPhrase は、IWordBreaker 実装の IWordBreaker::BreakText メソッドから呼び出されます。IPhraseSink オブジェクトが処理するフレーズは、Windows Search が元のクエリテキストを拡張するために使用します。

vtbl 4 HRESULT PutPhrase(LPWSTR pwcPhrase, DWORD cwcPhrase)

クエリ時のフレーズを IPhraseSink オブジェクトに格納します。

pwcPhrase	LPWSTR	in	フレーズを格納したバッファーへのポインター。
cwcPhrase	DWORD	in	pwcPhrase の文字数。クエリ時のフレーズのサイズに制限はありません。

戻り値

このメソッドは次のいずれかの値を返すことがあります。

戻り値	説明
S_OK	操作は正常に完了しました。
PSINK_E_QUERY_ONLY	PutPhrase がクエリ時ではなくインデックス作成時に呼び出されました。

解説(Remarks)

PutPhrase は、IWordBreaker 実装の IWordBreaker::BreakText メソッドから呼び出されます。IPhraseSink オブジェクトが処理するフレーズは、Windows Search が元のクエリテキストを拡張するために使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IPhraseSink "{CC906FF0-C058-101A-B554-08002B33B0E6}"
#usecom global IPhraseSink IID_IPhraseSink "{}"
#comfunc global IPhraseSink_PutSmallPhrase  3 wstr,int,wstr,int,int
#comfunc global IPhraseSink_PutPhrase       4 wstr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。