IConditionFactory::MakeLeaf method

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

Syntax


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

Parameters

pszPropertyName [in]

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.

cop [in]

Type: CONDITION_OPERATION

A CONDITION_OPERATION enumeration.

pszValueType [in]

Type: LPCWSTR

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

ppropvar [in]

Type: PROPVARIANT const*

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

pPropertyNameTerm [in]

Type: IRichChunk*

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

pOperationTerm [in]

Type: IRichChunk*

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

pValueTerm [in]

Type: IRichChunk*

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

fExpand [in]

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.

ppcResult [out, retval]

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

Minimum supported client

Windows XP with SP2, Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 with SP1 [desktop apps only]

Redistributable

Windows Desktop Search (WDS) 3.0

Header

Structuredquery.h

IDL

Structuredquery.idl

See also

Reference
IConditionFactory
CONDITION_TYPE
CONDITION_OPERATION
IConditionFactory2
ICondition
ICondition2

 

 

Show: