GetNextRows

HRESULT GetNextRows(
long lOffset, 
long cRowsRequested, 
HROW*& phRows, 
ULONG& cRows);

Parameters

lOffset

The offset from the next fetch position to begin fetching.

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.

Return Code

S_OK

 Method succeeded.

E_FAIL

Returned if the object is not attached.

Comments

Uses IRowset:GetNextRows to fetch the next sequence of requested rows.