IConditionGenerator interface (structuredquery.h)

Provides methods for handling named entities and generating special conditions.

Inheritance

The IConditionGenerator interface inherits from the IUnknown interface. IConditionGenerator also has these types of members:

Methods

The IConditionGenerator interface has these methods.

 
IConditionGenerator::DefaultPhrase

This method attempts to produce a phrase that, when recognized by this instance of IConditionGenerator, represents the type and value pair for an entity, relationship, or named entity.
IConditionGenerator::GenerateForLeaf

Generates a special query expression for what would otherwise become a leaf query expression.
IConditionGenerator::Initialize

Resets all states of the interface to default values and retrieves any necessary information from the schema.
IConditionGenerator::RecognizeNamedEntities

Identifies named entities in an input string, and creates a collection containing them.

Remarks

When an object that supports IConditionGenerator has been registered with a query parser as a semantic type T (using the IQueryParser::SetMultiOption method with the SQMO_GENERATOR_FOR_TYPE constant), and that query parser is about to generate a leaf condition node with semantic type T, the query parser first calls the IConditionGenerator::GenerateForLeaf method of the condition generator. If that method returns S_OK, the returned condition tree (which need not be a leaf node) is used. If it returns S_FALSE, then normal processing ia resumed, which generates a leaf node.

A query parser has condition generators preregistered for the known semantic types representing numbers, Booleans, date/time and file paths.

Requirements

   
Minimum supported client Windows XP with SP2, Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 with SP1 [desktop apps only]
Target Platform Windows
Header structuredquery.h

See also

CONDITION_CREATION_OPTIONS

CONDITION_OPERATION

CONDITION_TYPE

ICondition

ICondition2

IConditionFactory

Reference