ICondition interface (structuredquerycondition.h)

Provides methods for retrieving information about a search condition. An ICondition object represents the result of parsing an input string (using methods such as IQueryParser::Parse or IQuerySolution::GetQuery) into a tree of search condition nodes. A node can be a logical AND, OR, or NOT for comparing subnodes, or it can be a leaf node comparing a property and a constant value.

Inheritance

The ICondition interface inherits from IPersistStream. ICondition also has these types of members:

Methods

The ICondition interface has these methods.

ICondition::Clone Creates a deep copy of this ICondition object.
ICondition::GetComparisonInfo Retrieves the property name, operation, and value from a leaf search condition node. (ICondition.GetComparisonInfo)
ICondition::GetConditionType Retrieves the condition type for this search condition node, identifying it as a logical AND, OR, or NOT, or as a leaf node.
ICondition::GetInputTerms For a leaf node, ICondition::GetInputTerms retrieves information about what parts (or ranges) of the input string produced the property, the operation, and the value for the search condition node.
ICondition::GetSubConditions Retrieves a collection of the subconditions of the search condition node and the IID of the interface for enumerating the collection.
ICondition::GetValueNormalization Retrieves the character-normalized value of the search condition node.
ICondition::GetValueType Retrieves the semantic type of the value of the search condition node.

Remarks

Prior to Windows 7, this interface was only declared in structuredquery.h and structuredquery.idl. In Windows 7, this interface is also defined in structuredquerycondition.idl and structuredquerycondition.h.

The StructuredQuerySample demonstrates how to read lines from the console, parse them using the system schema, and display the resulting condition trees.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2, Windows Vista, Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2003 with SP1 [desktop apps only]
Target Platform	Windows
Header	structuredquerycondition.h
Redistributable	Windows Desktop Search (WDS) 3.0

See also

CONDITION_OPERATION

CONDITION_TYPE

ICondition2

IPersistStream

Reference