TBLT_RETC TBLT_ENTRY BltIx4FirstKey(TBLT_KH *khPtr, VOID *keyBufferPtr, ULONG *recNoPtr); khPtr I:index file control structure keyBufferPtr O:the first key recNoPtr O:recNo attached to the first keyThis routine gets the first key and its recNo.
This routine, like all BltIx4*Key()
routines, gets only the
key and recNo attached to that key. With the recNo, the programmer can
get the data record by using BltDataGetRecord()
. The
BltIx4Get*()
routines do this pairing automatically, and
typically are the routines to use to access the database.
Return: Non-zero indicates an error, otherwise the first key/recNo is returned.