TBLT_RETC TBLT_ENTRY BltIx4KeyForRecord(TBLT_KH *khPtr, VOID *keyBufferPtr, ULONG recNo, VOID *recordPtr); khPtr I:index file control structure keyBufferPtr O:key for recordPtr+recNo pair recNo I:recNo to match recordPtr I:data record whose key is being soughtThis routine returns the key used by the recordPtr/recNo pair.
This routine is typically used to determine the key that was stored in the index file for this record/recNo pair so that it may be deleted (for transaction rollback).
The recordPtr must already contain the data record, and recNo its record number.
If recNo is set to 0 on entry the index file is not searched for the key. Instead, this routine returns the key that this record would have if it were in the index file. This is useful to generate multi-part keys for lookups using BltIx4GetEqual(), for example (in 3.00.08+).
Return: Returns Non-zero indicates an error, otherwise the key is in keyBufferPtr.