Share via


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.

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

Header mapidefs.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

MAPI Structures
SRestriction

Other Resources

Messaging