SSubRestriction

Send Feedback

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

Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h

See Also

MAPI Structures | Messaging | SRestriction

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.