Partager via


SExistRestriction

4/8/2010

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 that have type PT_OBJECT.

Requirements

Header mapidefs.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

MAPI Structures
SRestriction

Other Resources

Messaging