SComparePropsRestriction 

The SComparePropsRestriction structure describes a compare property restriction, which tests two properties using a particular relational operator.

Quick Info

typedef struct _SComparePropsRestriction

{ 

     ULONG relop;

     ULONG ulPropTag1;

     ULONG ulPropTag2;

} SComparePropsRestriction;

Members

relop

Relational operator to use to compare the two properties. Possible values are:

RELOP_GE

The comparison is made based on a greater or equal first value.

RELOP_GT

The comparison is made based on a greater first value.

RELOP_LE

The comparison is made based on a lesser or equal first value.

RELOP_LT

The comparison is made based on a lesser first value.

RELOP_NE

The comparison is made based on unequal values.

RELOP_RE

The comparison is made based on LIKE (regular expression) values.

RELOP_EQ

The comparison is made based on equal values.

ulPropTag1

Property tag of the first property to be compared.

ulPropTag2

Property tag of the second property to be compared.

Remarks

The comparison order is (property tag 1) (relational operator) (property tag 2). The two properties compared should be of the same type. Attempting to compare properties of different types commonly returns the error value MAPI_E_TOO_COMPLEX.

The result of a property value restriction is undefined when the property does not exist. When a client requires well-defined behavior for such a restriction and is not sure whether the property exists   for example, it is not a required column of a table   it should create an AND restriction to join the compare property restriction with an exist restriction. Use an SExistRestriction14TSTW8 structure to define the exist restriction and an SAndRestriction1P03.9L structure to define the AND restriction.

The properties can be multivalued if the service provider supports it.

See Also