CurrentLowLevelKey
Get a key from the current Low-Level key buffer.
Short Name
GETCURKL()
Type
Low-Level function
Declaration
pVOID CurrentLowLevelKey(COUNT keyno, pVOID idxval);
Description
CurrentLowLevelKey() copies the current Low-Level key buffer for index file keyno into the buffer pointed to by idxval.
Return
CurrentLowLevelKey() returns idxval. A NULL signifies an error - check uerr_cod. See FairCom DB Error Codes for a complete listing of valid FairCom DB error values.
Example
COUNT keyfil;
TEXT keybuf[50];
if (CurrentLowLevelKey(keyfil,&keybuf) == NULL)
printf("\nError %d retrieving key.", uerr_cod);
Limitations
No check is made to determine if idxval points to a region sufficiently large to accept the key. If the area is too small, either code or data will be clobbered. Use GetCtFileInfo() to obtain the key length.
See also
CurrentISAMKey, GetCtFileInfo