IConditionGenerator::RecognizeNamedEntities メソッド (structuredquery.h)

入力文字列内の名前付きエンティティを識別し、それらを含むコレクションを作成します。 各名前付きエンティティの値は文字列として表され、 IConditionGenerator::GenerateForLeaf によって使用されます。 文字列は他のコンポーネントによって検査されないため、任意のデータを含め、任意の形式にすることができます。

構文

HRESULT RecognizeNamedEntities(
  [in]      LPCWSTR               pszInputString,
  [in]      LCID                  lcidUserLocale,
  [in]      ITokenCollection      *pTokenCollection,
  [in, out] INamedEntityCollector *pNamedEntities
);

パラメーター

[in] pszInputString

種類: LPCWSTR

解析する入力文字列。

[in] lcidUserLocale

種類: LCID

名前付きエンティティを認識する必要がある LCID。

[in] pTokenCollection

種類: ITokenCollection*

入力文字列がどのようにトークン化されたかを示す ITokenCollection オブジェクトへのポインター。

[in, out] pNamedEntities

型: INamedEntityCollector*

入力時に、 には INamedEntityCollector または NULL が含まれます。 戻り値には、名前付きエンティティの INamedEntityCollector コレクションが含まれます。

戻り値

種類: HRESULT

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

解説

入力文字列、ユーザー ロケール (通常はユーザーの既定のロケール) と入力文字列のトークン化を指定すると、 IConditionGenerator::RecognizeNamedEntities メソッドは、その入力文字列内の名前付きエンティティを識別し、各エンティティを名前付きエンティティ コレクションに追加できる必要があります。

要件

   
サポートされている最小のクライアント WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー structuredquery.h

関連項目

CONDITION_CREATION_OPTIONS

CONDITION_OPERATION

CONDITION_TYPE

ICondition

ICondition2

IConditionFactory

IConditionGenerator

参照