INamedEntityCollector::Add メソッド (structuredquery.h)

解析される入力文字列のトークン化されたスパンで識別されるように、この INamedEntityCollector コレクションに 1 つの (潜在的な) 名前付きエンティティを追加します。

構文

HRESULT Add(
  [in] ULONG                  beginSpan,
  [in] ULONG                  endSpan,
  [in] ULONG                  beginActual,
  [in] ULONG                  endActual,
  [in] IEntity                *pType,
  [in] LPCWSTR                pszValue,
  [in] NAMED_ENTITY_CERTAINTY certainty
);

パラメーター

[in] beginSpan

種類: ULONG

先頭の引用符を含む、トークン全体の範囲の先頭。

[in] endSpan

種類: ULONG

末尾の引用符を含む、トークン全体の範囲の末尾。

[in] beginActual

種類: ULONG

名前付きエンティティの可能性を識別するトークンスパンの部分の先頭。

[in] endActual

種類: ULONG

名前付きエンティティの可能性を識別するトークンスパンの部分の末尾。

[in] pType

種類: IEntity*

名前付きエンティティのセマンティック型。

[in] pszValue

種類: LPCWSTR

文字列としてのエンティティの名前。

[in] certainty

種類: NAMED_ENTITY_CERTAINTY

次のいずれかの値です。

値	説明
NEC_LOW	この名前付きエンティティである可能性がありますが、追加の証拠をお勧めします。
NEC_MEDIUM	おそらく、この名前付きエンティティです。使用しても問題ありません。
NEC_HIGH	ほぼ確実に、この名前付きエンティティです。他の可能性を破棄しても問題ありません。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

クエリ パーサーが入力文字列を条件ノードに解析すると、パーサーは IConditionGenerator オブジェクトを呼び出し、 INamedEntityCollector::Add を呼び出して、入力文字列内の名前付きエンティティを収集します。 IConditionGenerator オブジェクトは、入力文字列で認識される名前付きエンティティごとに、このメソッドを呼び出す必要があります。 各エンティティについて、条件ジェネレーターは次の情報を提供する必要があります。

• 対象となる入力文字列の部分
• 名前付きエンティティのセマンティック型
• 名前付きエンティティの値の文字列表現
• 入力が実際にその名前付きエンティティであるという確実性のレベル

入力文字列の解釈で名前付きエンティティが使用された場合、条件ジェネレーターの GenerateForLeaf メソッドが引数の 1 つとして値文字列と共に呼び出されます。

最初の 4 つの引数 beginSpan = beginActual<endActual = endSpan の間で、次のリレーションシップを維持する必要があります。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	structuredquery.h
再頒布可能パッケージ	Windows デスクトップ検索 (WDS) 3.0