Share via


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;

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