TBLT_RETC TBLT_ENTRY BltIx4GetEqual(TBLT_KH *khPtr,
VOID *keyBufferPtr,
ULONG *recNoPtr,
VOID *recordPtr);
khPtr I:index file control structure
keyBufferPtr I:key to find
recNoPtr IO:recNo to match (or 0)/recNo of key found
recordPtr O:record data of found key
This routine finds the exact match for the key in keyBufferPtr and the
recNo in recNoPtr and returns its data record. If recNo is passed as zero,
the first key matched is used (that is, the key with the lowest recNo).
This routine only finds exact matches. If the TBLT_DH.flags bit
FLAGS_SKIP_DELETED_BIT, of khPtr->xbLinkPtr->flags, is set, this
routine returns a EXB_KEY_NOT_FOUND if the found key has a data
record marked with a * (star) in the delete tag field (the first
byte of the data record).
Note: The key to find must match exactly with a key in the index file, for all keyLength bytes. The compare does not stop at a \0, even if the key is a character type.
Return: Non-zero indicates an error, otherwise the recNo/recordPtr is returned.