virtual bool CRBase::MoveNext(LONG nSkipped=0);

Return Value

        true if successful; otherwise false.

Parameter

        [in] nSkipped:

                The signed count of rows to skip before fetching rows.

Remark

        Moves a cursor to the next record skipped by nSkipped. Specifically if nSkipped is -1, copies the columns data of the current record from a provider to a client again. If nSkipped is less than -1, it moves the cursor back to a previous record and fetches the record. To enable nSkipped to be less than -1, the value of the DBPROP_CANSCROLLBACKWARDS property must be set to true.

        The advantage of use of the variable nSkipped is to pinpoint a record at the fast speed without fetching records sequentially one by one. For how to use this function, see the example Scroll. Additionally, a user can use CRBaseEx functions to pinpoint records, such as CRBaseEx::FindNextRow, CRBaseEx::GetRowsAt, CRBaseEx::Seek, CRBaseEx::GetRowsAtRatio and CRBaseEx::GetApproximatePosition.

CRBase Class Overview & Class Members