_BtStepFirst() Function


<< Click to Display Table of Contents >>

Navigation:  Low Level Functions >


_BtStepFirst() Function


Previous pageReturn to chapter overviewNext page





Position the Btrieve file on the first physical record







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







<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.








LOGICWas the move to the first record succesfull.







If the Step First 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



_BtStepLast(), _BtStepnext(), _BtStepPrevious()