_BtStepFirst() Function
<< Click to Display Table of Contents >>
_BtStepFirst() Function
|
|
Purpose
Position the Btrieve file on the first physical record
Prototype
FUNCTION _BtStepFirst ( 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
LOGIC | Was the move to the first record succesfull. |
Description
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()