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