SExistRestriction 

The SExistRestriction structure describes an exist restriction, which is used to test whether or not a particular property exists.

Quick Info

Header file:

MAPIDEFS.H

 

typedef struct _SExistRestriction

     ULONG ulReserved1;

     ULONG ulPropTag;

     ULONG ulReserved2;

} SExistRestriction;

 

Members

ulReserved1

Reserved; must be zero.

ulPropTag

Property tag identifying the property to be tested for existence.

ulReserved2

Reserved; must be zero.

 

Remarks

The exist restriction is used to guarantee meaningful results for other types of restrictions that involve properties, such as property and content restrictions. When a restriction that involves a property is passed to IMAPITable::Restrict or IMAPITable::FindRow and the property does not exist, the results of the restriction are undefined. By creating an AND restriction that joins the property restriction with an exist restriction, a caller can be guaranteed accurate results.

Exist restrictions cannot be used with subobject properties, or properties that have type PT_OBJECT.

See Also

SRestriction1TRSEKP