Export (0) Print
Expand All

3.1.4.1 Preparing the Table

When a higher layer, or the user, needs to modify the column set, the client MUST send a RopSetColumns ROP request ([MS-OXCROPS] section 2.2.5.1) to change the column set.

When a higher layer, or the user, needs to modify the sort order, the client MUST send a RopSortTable ROP request ([MS-OXCROPS] section 2.2.5.2) to change the sort order. The RopSortTable ROP is only supported on contents tables.

In order to categorize a table, the category properties MUST be the first properties in the SortOrders array passed to the RopSortTable ROP. The number of category properties MUST be set in the CategoryCount field passed to RopSortTable.

When a higher layer, or the user, needs to filter the rows returned in a RopQueryRows ([MS-OXCROPS] section 2.2.5.4), RopFindRow ([MS-OXCROPS] section 2.2.5.13), or RopExpandRow ([MS-OXCROPS] section 2.2.5.16) ROP response, the client MUST send a RopRestrict ROP request ([MS-OXCROPS] section 2.2.5.3) to change the filter applied to the table.

When a higher layer, or the user, needs to clean up the table by removing old sorts, column sets, or restrictions, the client MUST send a RopResetTable ROP request ([MS-OXCROPS] section 2.2.5.15). After doing this, the client MUST send a RopSetColumns ROP request before sending a RopQueryRows, RopFindRow, or RopExpandRow ROP request.

If a request for a RopSetColumns, RopSortTable, or RopRestrict ROP fails, the client can send a RopResetTable ROP request before retrying the failed message.

If a RopSetColumns ROP request fails, the client MUST consider the table as invalid and MUST NOT send any other ROPs on it until a successful RopSetColumns or RopResetTable ROP request is made.

If a RopSortTable ROP request fails, the client MUST consider the table to be invalid and MUST NOT send any ROPs on it until a successful RopSortTable or RopResetTable ROP request is made.

If a RopRestrict ROP request fails, the client MUST consider the table to be invalid and MUST NOT send any ROPs on it until a successful RopRestrict or RopResetTable ROP request is made.

Show:
© 2016 Microsoft