Export (0) Print
Expand All

3.1.4.1 Retrieving Existing Rules

When a higher layer needs to inspect the standard rules or needs to display these rules (4) to the user, the client MUST retrieve the rules (4) from the server using the RopGetRulesTableROP request ([MS-OXCROPS] section 2.2.11.2) as specified in section 2.2.2. The higher level MUST use the returned table handle, as described in [MS-OXCTABL] section 1.5, to access rule (4) properties.

The table returned by the RopGetRulesTableROP contains one rule (4) per row. The columns available in this table are the properties specified in section 2.2.1.3.1, and their values are the same as those the client set previously using a RopModifyRules ROP request ([MS-OXCROPS] section 2.2.11.1). If there isn't a value stored on the server for one of the rule (4) property columns, then when the client retrieves the rule (4) via a RopGetRulesTable ROP request, the server returns either a default value or an error for that column; which default values or errors are determined by the server implementation.

When a higher layer needs to inspect the extended rules or needs to display the extended rules to the user, the client MUST retrieve the FAI contents table of the folder of interest and use a PropertyRestriction restriction to restrict the folder to messages where the value of the PidTagMessageClass property ([MS-OXCMSG] section 2.2.1.3) is equal to "IPM.ExtendedRule.Message". For more details about retrieving an FAI contents table and restricting a table, see [MS-OXCFOLD] section 3.1.4.10 and [MS-OXCTABL] section 2.2.2.4.

Show:
© 2014 Microsoft