2.2.1.20 CRowSeekByBookmark

  • Article

The CRowSeekByBookmark structure identifies the bookmarks from which to begin retrieving rows for a CPMGetRowsIn message.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

_chapt

_cBookmarks

_aBookmarks (variable)

...

_maxRet

_ascRet (variable)

...

_chapt (4 bytes): A 32-bit value representing the handle of the rowset chapter.

_cBookmarks (4 bytes): A 32-bit unsigned integer representing the number of elements in _aBookmarks array.

_aBookmarks (variable): An array of bookmark handles (each represented by 4 bytes) as obtained from a CPMGetRowsOut message.

_maxRet (4 bytes): A 32-bit unsigned integer representing the number of elements in the _ascRet array.

_ascRet (variable): An array of HRESULT values. When the CRowSeekByBookmark structure is sent as part of the CPMGetRowsIn request, the number of entries in the array MUST be equal to _maxRet. When sent by the client, the values MUST be set to zero when sent and MUST be ignored on receipt. When sent by the server (as part of the CPMGetRowsOut message), the values in the array indicate the result status for each row retrieval.