2.2.2.9.1 RopSeekRow ROP Request Buffer

The following descriptions define valid fields for the RopSeekRow ROP request buffer ([MS-OXCROPS] section 2.2.5.8.1).

Origin (1 byte): An enumeration that contains the Bookmark field array indicating the starting position of the seek operation. This field's value MUST be one of the predefined bookmark values that are specified in section 2.2.2.1.1.

RowCount (4 bytes): A signed integer that indicates the number of rows to seek, starting from the bookmark. To seek forward from the bookmark, the value MUST be positive; to seek backwards, the value MUST be negative.

WantRowMovedCount (1 byte): A Boolean that specifies whether the actual number of rows moved MUST be returned by the server. This field MUST be set to "TRUE" (0x01) or "FALSE" (0x00). If this field is set to "TRUE" (0x01), the server MUST return the actual number of rows moved. If this field is set to "FALSE" (0x00), the value of the HasSoughtLess and RowsSought fields specified in section 2.2.2.9.2 are undefined, and the client MUST ignore them.

The actual number of rows moved can differ from the requested number of rows if the beginning or end of the table is encountered before moving the requested number of rows.