Share via

SSubRestriction

  • Article

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

Syntax

typedef struct _SSubRestriction { 
  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

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

See Also

MAPI Structures

Messaging

SRestriction

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.