SSubRestriction
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Describes a sub-object restriction which is used to filter the rows of a message's attachment or recipient table.
Header file: |
Mapidefs.h |
typedef struct _SSubRestriction
{
ULONG ulSubObject;
LPSRestriction lpRes;
} SSubRestriction;
Members
ulSubObject
Type of sub-object to serve as the target for the restriction. Possible values are as follows:PR_MESSAGE_RECIPIENTS
Apply the restriction to a message's recipient table.PR_MESSAGE_ATTACHMENTS
Apply the restriction to a message's attachment table.
lpRes
Pointer to an SRestriction structure.
Remarks
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.