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.

Return Value

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

Remarks

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.

Requirements

Header: atldbcli.h

See Also

Reference

CRowset Class

CRowset::MoveFirst

CRowset::MoveToBookmark

CRowset::MovePrev

CRowset::MoveLast