F.87 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 Appendix A "c-tree Plus Error Codes" of the c-tree Plus Programmer's Reference Guide for a complete listing of valid c-tree Plus 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