Export (0) Print
Expand All

CRowset::MoveNext 

Moves the cursor to the next record.


HRESULT MoveNext( ) throw( ); 
HRESULT MoveNext( 
   LONG lSkip, 
   bool bForward = true  
) throw( );

Parameters

lSkip

[in] The number of rows to skip before fetching.

bForward

[in] Pass true to move forward to the next record, false to move backward.

A standard HRESULT. When the end of the rowset has been reached, returns DB_S_ENDOFROWSET.

Fetches the next sequential row from the CRowset object, remembering the previous position. Optionally, you can choose to skip ahead lSkip rows or move backward.

This method requires that you set the following properties before calling Open on the table or command containing the rowset:

  • DBPROP_CANSCROLLBACKWARDS must be VARIANT_TRUE if lSkip < 0

  • DBPROP_CANFETCHBACKWARDS must be VARIANT_TRUE if bForward = false

Otherwise (if lSkip >= 0 and bForward = true), you do not need to set any additional properties.

Community Additions

ADD
Show:
© 2015 Microsoft