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 SCommentRestrictionstructure 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 SRestrictionstructure.

lpProp

Pointer to an array of SPropValuestructures, each containing the property tag and value for a named property.

Remarks

The SCommentRestrictionstructure 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::Restrictmethod. There is no effect on the rows returned by the IMAPITable::QueryRowsmethod after an IMAPITable::Restrictcall has been made.

The SCommentRestrictionstructure 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 SCommentRestrictionstructure. Saving a property name is not possible in a property restriction because the associated SPropertyRestrictionstructure holds only the property tag.

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

Other Resources

Messaging