CONDITION_CREATION_OPTIONS enumeration (structuredquery.h)

Provides a set of flags to be used with the following interfaces to indicate the type of condition tree node: ICondition, ICondition2, IConditionFactory, IConditionFactory2, and IConditionGenerator.

Syntax

typedef enum CONDITION_CREATION_OPTIONS {
  CONDITION_CREATION_DEFAULT = 0,
  CONDITION_CREATION_NONE = 0,
  CONDITION_CREATION_SIMPLIFY = 0x1,
  CONDITION_CREATION_VECTOR_AND = 0x2,
  CONDITION_CREATION_VECTOR_OR = 0x4,
  CONDITION_CREATION_VECTOR_LEAF = 0x8,
  CONDITION_CREATION_USE_CONTENT_LOCALE = 0x10
} ;

Constants

 
CONDITION_CREATION_DEFAULT
Value: 0
Indicates that the condition is set to the default value.
CONDITION_CREATION_NONE
Value: 0
Indicates that the condition is set to NULL.
CONDITION_CREATION_SIMPLIFY
Value: 0x1
Indicates that you should simplify the returned condition as much as possible. In some cases this flag indicates that the returned condition is not newly created but refers to an existing object.
CONDITION_CREATION_VECTOR_AND
Value: 0x2
Indicates that you should create an AND condition of leaves with vector elements as values, instead of attempting to create a leaf condition with VT_VECTOR set in the PROPVARIANT.
CONDITION_CREATION_VECTOR_OR
Value: 0x4
Indicates that you should create an OR condition of leaves with vector elements as values, instead of attempting to create a leaf condition with VT_VECTOR set in the PROPVARIANT.
CONDITION_CREATION_VECTOR_LEAF
Value: 0x8
Indicates that you should allow the creation of a leaf condition with VT_VECTOR set in the PROPVARIANT.
CONDITION_CREATION_USE_CONTENT_LOCALE
Value: 0x10
Indicates that you should ignore any specified locale and use the currently selected content locale IConditionFactory2::CreateStringLeaf and IConditionFactory2::CreateLeaf.

Remarks

>Only one of following flags should be set simultaneously:

  • CONDITION_CREATION_VECTOR_AND
  • CONDITION_CREATION_VECTOR_OR
  • CONDITION_CREATION_VECTOR_LEAF
However, if none of these flags is set, then attempting to create a leaf condition with VT_VECTOR set in the PROPVARIANT results in failure.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Header structuredquery.h

See also

CONDITION_OPERATION

CONDITION_TYPE

Reference