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.

See Also

Reference

SRestriction

Concepts

MAPI Structures