IConditionFactory::MakeLeaf method (structuredquery.h)

Creates a leaf condition node that represents a comparison of property value and constant value.

Syntax

HRESULT MakeLeaf(
  [in]          LPCWSTR             pszPropertyName,
  [in]          CONDITION_OPERATION cop,
  [in]          LPCWSTR             pszValueType,
  [in]          const PROPVARIANT   *ppropvar,
  [in]          IRichChunk          *pPropertyNameTerm,
  [in]          IRichChunk          *pOperationTerm,
  [in]          IRichChunk          *pValueTerm,
  [in]          BOOL                fExpand,
  [out, retval] ICondition          **ppcResult
);

Parameters

[in] pszPropertyName

Type: LPCWSTR

The name of a property to be compared, or NULL for an unspecified property. The locale name of the leaf node is LOCALE_NAME_USER_DEFAULT.

[in] cop

Type: CONDITION_OPERATION

A CONDITION_OPERATION enumeration.

[in] pszValueType

Type: LPCWSTR

The name of a semantic type of the value, or NULL for a plain string.

[in] ppropvar

Type: PROPVARIANT const*

The constant value against which the property value should be compared.

[in] pPropertyNameTerm

Type: IRichChunk*

A pointer to an IRichChunk that identifies the range of the input string that represents the property. It can be NULL.

[in] pOperationTerm

Type: IRichChunk*

A pointer to an IRichChunk that identifies the range of the input string that represents the operation. It can be NULL.

[in] pValueTerm

Type: IRichChunk*

A pointer to an IRichChunk that identifies the range of the input string that represents the value. It can be NULL.

[in] fExpand

Type: BOOL

If TRUE and pszPropertyName identifies a virtual property, the resulting node is not a leaf node; instead, it is a disjunction of leaf condition nodes, each of which corresponds to one expansion of the virtual property.

[out, retval] ppcResult

Type: ICondition**

Receives a pointer to the new ICondition leaf node.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

For more information about leaf node terms (property, value, and operation), see ICondition::GetInputTerms.

A virtual property has one or more metadata items in which the key is "MapsToRelation" and the value is a property name (which is one expansion of the property). For more information about metadata, see MetaData.

Requirements

See also

CONDITION_OPERATION

CONDITION_TYPE

ICondition

ICondition2

IConditionFactory

IConditionFactory2

Reference