TBLT_RETC TBLT_ENTRY BltIx4GetEqualOrLesser(TBLT_KH *khPtr,
VOID *keyBufferPtr,
ULONG *recNoPtr,
VOID *recordPtr);
khPtr I:index file control structure
keyBufferPtr IO:key to find/key found
recNoPtr IO:recNo to match (or 0)/recNo of key found
recordPtr O:record data of found key
This routine finds either the exact match for the key in keyBufferPtr and
the recNo in recNoPtr (if not zero, the first key-match if zero), or the
previous, lesser key and its recNoPtr and returns the key, the record number,
and the data record of that key.
The previous lesser key is the key that would have preceded the exact key
to find had that key been in the index file. If the TBLT_DH.flags bit
FLAGS_SKIP_DELETED_BIT, of khPtr->xbLinkPtr->flags, is set,
this routine skips over all data records marked with a * (star)
in the delete tag field (the first byte of the data record).
Return: Non-zero indicates an error, otherwise
the keyBufferPtr/recNo/recordPtr is returned.