GetRows Using Bookmark

HRESULT GetRows(
const CBookmark& bmk, 
long lOffset, 
long cRowsRequested, 
HROW*& phRows, 
ULONG& cRows);

Parameters

bmk

Bookmark identifying the row to begin the fetch.

lOffset

Signed offset from the row identified by bmk to begin the fetch.

cRowsRequested

The number of rows to fetch.

phRows

Reference to buffer to receive HROWs. If this argument is NULL then the callee will allocate an array large enough to hold the number of HROWs returned. Use CRowset::FreeRows, or a combination of CRowset::ReleaseRows and CoTaskMemFree to release the HROWS and free the callee-allocated buffer. If this argument is not NULL, then the caller must have allocated enough space to hold the requested number of HROWs.

cRows

The number of HROWs actually fetched.

Return Code

S_OK

Method succeeded.

E_NOINTERFACE 
Returned if IRowsetLocate is not available.

E_FAIL
Returned if the object is not attached.

Comments

Uses IRowsetLocate::GetRowsAt to retrieve the requested number of HROWs from the data source.