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