IConditionFactory2::CreateLeaf メソッド (structuredquery.h)

[アーティクル]
08/26/2023

任意の値のリーフ条件ノードを作成します。返されるオブジェクトは、ICondition と ICondition2 をサポートしています。

構文

HRESULT CreateLeaf(
  [in]           REFPROPERTYKEY             propkey,
  [in]           CONDITION_OPERATION        cop,
  [in]           REFPROPVARIANT             propvar,
  [in, optional] LPCWSTR                    pszSemanticType,
  [in, optional] LPCWSTR                    pszLocaleName,
  [in, optional] IRichChunk                 *pPropertyNameTerm,
  [in, optional] IRichChunk                 *pOperationTerm,
  [in, optional] IRichChunk                 *pValueTerm,
  [in]           CONDITION_CREATION_OPTIONS cco,
  [in]           REFIID                     riid,
  [out]          void                       **ppv
);

パラメーター

[in] propkey

型: REFPROPERTYKEY

リーフ条件のプロパティの名前を REFPROPERTYKEY として指定します。リーフに特定のプロパティがない場合は、PKEY_Nullを使用します。

[in] cop

種類: CONDITION_OPERATION

CONDITION_OPERATION列挙。リーフに特定の操作がない場合は、 COP_IMPLICITを使用します。

[in] propvar

型: REFPROPERTYKEY

リーフ条件のプロパティ値を REFPROPERTYKEY として指定します。

[in, optional] pszSemanticType

種類: LPCWSTR

値のセマンティック型の名前。プレーン文字列の 場合は NULL 。新しく作成されたリーフが未解決の名前付きエンティティである場合、pszSemanticType はセマンティック型の名前にする必要があります。それ以外の場合は NULL。

[in, optional] pszLocaleName

種類: LPCWSTR

比較するロケールの名前。指定されていないロケールの 場合は NULL 。 propvar に文字列値が含まれていない場合は、pszLocaleName をLOCALE_NAME_USER_DEFAULTする必要があります。それ以外の場合、pszLocaleName は文字列の言語を反映する必要があります。または、 pszLocaleName を LOCALE_NAME_INVARIANTすることもできます。

[in, optional] pPropertyNameTerm

種類: IRichChunk*

プロパティを表す入力文字列の範囲を識別する IRichChunk へのポインター。 NULL を指定できます。

[in, optional] pOperationTerm

種類: IRichChunk*

操作を表す入力文字列の範囲を識別する IRichChunk へのポインター。 NULL を指定できます。

[in, optional] pValueTerm

種類: IRichChunk*

値を表す入力文字列の範囲を識別する IRichChunk へのポインター。 NULL を指定できます。

[in] cco

種類: CONDITION_CREATION_OPTIONS

CONDITION_CREATION_OPTIONS列挙体としてのリーフ条件の条件作成操作。

[in] riid

型: REFIID

列挙インターフェイスの目的の IID: IEnumUnknown、 IEnumVARIANT、または (否定条件の場合) IID_ICondition。

[out] ppv

型: void**

0 個以上の ICondition オブジェクトと ICondition2 オブジェクトへのポインターを受け取ります。

戻り値

このメソッドは値を返しません。

解説

既定のオプションでは、 CONDITION_CREATION_DEFAULT フラグを使用します。

リーフ条件が文字列を解析して取得された場合、1 つ以上のパラメーター pPropertyNameTerm、 pOperationTerm 、 および pValueTerm を IRichChunk インターフェイス ( ICondition::GetInputTerms メソッドを使用して取得) で表すことができます。それ以外の場合、3 つのパラメーターはすべて NULL にすることができます。

リーフノードの用語 (プロパティ、値、および操作) の詳細については、「 ICondition::GetInputTerms」を参照してください。

仮想プロパティには、キーが "MapsToRelation" で、値がプロパティ名 (プロパティの 1 つの拡張) である 1 つ以上のメタデータ項目があります。メタデータの詳細については、「 MetaData」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	structuredquery.h