SExistRestriction
The SExistRestriction structure describes an existence restriction, which is used to test whether or not a particular property exists as a column in the table.
Syntax
struct {
ULONG ulReserved1;
ULONG ulPropTag;
ULONG ulReserved2;
} SExistRestriction;
Members
- ulReserved1
Reserved; must be zero. - ulPropTag
Property tag identifying the column to be tested for existence in each row. - ulReserved2
Reserved; must be zero.
Remarks
The existence 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. 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 existence restriction, a caller can be guaranteed accurate results.
Existence restrictions cannot be used with subobject properties — properties that have type PT_OBJECT.
Requirements
Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h
See Also
MAPI Structures | Messaging | SRestriction
Send Feedback on this topic to the authors