This topic has not yet been rated - Rate this topic

SSubRestriction

Office 2007

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.

Reference

SRestriction

Concepts

MAPI Structures

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)