Share via


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

typedef struct _SExistRestriction { 
  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: Windows Mobile 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.

© 2005 Microsoft Corporation. All rights reserved.