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