Important:
This is retired content. 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 content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The SSubRestrictionstructure 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 SRestrictionstructure.

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_COMPLEXfrom its IMAPITable::Restrictmethod.

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