TBLT_RETC TBLT_ENTRY BltIx4GetEqualOrGreater(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 otherwise), or the
next, greater key and its recNoPtr and returns the key, the record number, and
the data record of that key.
The next greater key is the key that would have followed 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.