This documentation is archived and is not being maintained.


This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Describes a sub-object restriction which is used to filter the rows of a message's attachment or recipient table.

Header file:


typedef struct _SSubRestriction
  ULONG ulSubObject;
  LPSRestriction lpRes;
} SSubRestriction;


Type of sub-object to serve as the target for the restriction. Possible values are as follows:


Apply the restriction to a message's recipient table.


Apply the restriction to a message's attachment table.


Pointer to an SRestriction structure.

Sub-object restrictions are not supported by all tables. Typically, only folder contents tables and search results folders support them. For example, sub-object restrictions are used to find a message that has a particular type of attachment or recipient.

If an implementation does not support sub-object restrictions, it returns MAPI_E_TOO_COMPLEX from its IMAPITable::Restrict or IMAPITable::FindRow methods.

For a general discussion of how restrictions work, see About Restrictions.