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
SRestriction