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 不包含字符串值，则应LOCALE_NAME_USER_DEFAULT pszLocaleName ;否则， pszLocaleName 应反映字符串的语言。或者，可以LOCALE_NAME_INVARIANT pszLocaleName 。

[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**

接收指向零个或多个 ICondition 和 ICondition2 对象的指针。

返回值

此方法不返回值。

备注

对于默认选项，请使用 CONDITION_CREATION_DEFAULT 标志。

如果叶条件是通过分析字符串获取的，则一个或多个参数 pPropertyNameTerm、 pOperationTerm 和 pValueTerm 可由 IRichChunk 接口表示， (通过 ICondition：：GetInputTerms 方法) 获取。否则，所有三个参数都可以为 NULL。

有关叶节点术语 (属性、值和操作) 的详细信息，请参阅 ICondition：：GetInputTerms。

虚拟属性具有一个或多个元数据项，其中键为“MapsToRelation”，值为属性名称 (属性) 的一个扩展。有关元数据的详细信息，请参阅 MetaData。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	structuredquery.h