SCommentRestriction

Send Feedback

The SCommentRestriction structure describes a comment restriction, which is used to annotate a restriction.

Syntax

struct { 
  ULONG cValues; 
  LPSRestriction lpRes; 
  LPSPropValue lpProp; 
} SCommentRestriction; 

Members

  • cValues
    Count of property values in the array pointed to by lpProp.
  • lpRes
    Pointer to an SRestriction structure.
  • lpProp
    Pointer to an array of SPropValue structures, each containing the property tag and value for a named property.

Remarks

The SCommentRestriction structure associates an object with a set of named properties. Comment restrictions are unlike other restrictions because they are not evaluated. That is, they are ignored by the IMAPITable::Restrict method. There is no effect on the rows returned by the IMAPITable::QueryRows method after an IMAPITable::Restrict call has been made.

The SCommentRestriction structure can be used to keep application-specific information with a restriction when it is saved on disk. For example, a client saving the name of a named property used in a property restriction can do so in an SCommentRestriction structure. Saving a property name is not possible in a property restriction because the associated SPropertyRestriction structure holds only the property tag.

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 | SPropValue | SRestriction

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.