3.1.4.2 Querying the Table

When a higher layer, or the user, requests tabular data from a table, the client MUST retrieve that information using a RopQueryRows ([MS-OXCROPS] section 2.2.5.4) or RopFindRow ([MS-OXCROPS] section 2.2.5.13) ROP request.

The client can get the whole table by sending a RopQueryRows ROP request repeatedly with the Advance option until the RopQueryRows ROP response returns zero rows (indicating the end of the table has been reached).

When a higher layer, or the user, needs to know the list of available columns for the table, the client MUST get the column list by sending a RopQueryColumnsAll ROP request ([MS-OXCROPS] section 2.2.5.12).

When a higher layer, or the user, needs to collapse rows that are grouped into a category into one header row, the client MUST send a RopCollapseRow ROP request ([MS-OXCROPS] section 2.2.5.17).

When a higher layer, or the user, needs to expand rows that are grouped into a collapsed header row, the client MUST send a RopExpandRow ROP request ([MS-OXCROPS] section 2.2.5.16). The client can retrieve some or all of the rows expanded.

If the client is going to expand and collapse categories, it MUST include the PidTagInstID property (section 2.2.1.1) in the PropertyTags field of the RopSetColumns ROP request ([MS-OXCROPS] section 2.2.5.1), and use the value of that property in RopExpandRow, RopCollapseRow, and RopGetCollapseState ([MS-OXCROPS] section 2.2.5.18) ROP requests.

Show: