SSubRestriction

4/8/2010

The SSubRestriction structure describes a subobject restriction, which is used to filter the rows of a message attachment or recipient table.

Syntax

struct { 
  ULONG ulSubObject; 
  LPSRestriction lpRes; 
} SSubRestriction; 

Members

• ulSubObject
  Type of subobject to serve as the target for the restriction. Possible values are as follows:

  PR_MESSAGE_RECIPIENTS

  Apply the restriction to a message recipient table.

  PR_MESSAGE_ATTACHMENTS

  Apply the restriction to a message attachment table.

• lpRes
  Pointer to an SRestriction structure.

Remarks

Subobject restrictions are not supported by all tables. Typically, only folder contents tables and search-results folders support them. For example, subobject restrictions are used to find a message that has a particular type of attachment or recipient.

If an implementation does not support subobject restrictions, it returns MAPI_E_TOO_COMPLEX from its IMAPITable::Restrict method.

Requirements

See Also

Reference

MAPI Structures
SRestriction

Other Resources

Messaging