2.2.6.1.2.11 CommentRestriction Structure
The CommentRestriction structure, unlike other restriction structures, is not evaluated and is used only for reference by the application. The comment condition is used to keep additional application-specific information with the restriction in the form of an arbitrary list of property tag and value pairs.
The CommentRestriction structure has the following format.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
RestrictionType |
|||||||||||||||||||||||||||||||
|
cValues |
|||||||||||||||||||||||||||||||
|
Reserved |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
PropValueNum |
|||||||||||||||||||||||||||||||
|
PropTags (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
PropValues (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
SubCondition (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
RestrictionType (4 bytes): This field specifies the type of restriction and MUST be set to RES_COMMENT (0x0000000A) for the CommentRestriction structure.
cValues (4 bytes): This field MUST have the same value as the PropValueNum field.
Reserved (8 bytes): The application can fill this field with any value when writing the stream. The application MUST ignore the value of this field when reading the stream.
PropValueNum (4 bytes): This field is specifies the number of structures contained in the PropTags field and the PropValues field.
PropTags (variable): An array of PropertyTag structures, each of which specifies the property tag of a property that is specified in the PropValues field. For details about the PropertyTag structure, see [MS-OXCDATA] section 2.9. The valid property types for restrictions are specified in section 2.2.6.1.3. The number of PropertyTag structures in the array is specified by the PropValueNum field.
PropValues (variable): An array of PropertyValue structures. For details about the PropertyValue structure, see section 2.2.6.1.4. The number of structures is specified by the PropValueNum field.
SubCondition (variable): This field contains a single subrestriction that makes up the CommentRestriction structure. The subrestriction MUST be one of the structures that is specified in section 2.2.6.1.2.1 through section 2.2.6.1.2.11.