_BtStepNext() Function

 

<< Click to Display Table of Contents >>

Navigation:  Low Level Functions >

 

_BtStepNext() Function

 

Previous pageReturn to chapter overviewNext page

 

Purpose

 

 

Position the Btrieve file on the next physical record

 

 

 

Prototype

 

 

FUNCTION _BtStepNext ( hFile AS PTR, ptrData AS PTR, nRecLen REF WORD )  AS LOGIC

 

 

 

Argument(s)

 

 

<hFile>File handle that was returned by _BtOpen
<ptrData>Pointer to the data structure.
<nRecLen>Length of the data structure. This value must be at least as long as the fixed-length portion of the record.

 

 

 

 

Return

 

 

LOGICWas the move to the first record succesfull.

 

 

 

Description

 

 

If the Step Next operation is unsuccessful, the MicroKernel may return one of the following status codes:

03 File Not Open
09 End of File (when the file is empty)
22 Data Buffer Length

 

 

 

See Also

 

 

_BtStepFirst(), _BtStepLast(), _BtStepPrevious()