This documentation is archived and is not being maintained.

SSubRestriction

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:

Mapidefs.h

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

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.

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.

Show: