KISAMReadKey

int KISAMReadKey(KHAND handle, int path, char *lpRecbuf, char *lpKeybuf, ROWID *lpRowid)

Parameter Type Purpose
handle KHAND handle of table to be searched
path int index path to which the key applies
lpRecbuf char * record buffer to receive the row. May be NULL if only key required.
lpKeybuf char * buffer to hold the key. May be NULL if not required.
lpRowid ROWID * this location will be updated with the rowid of the record.

This will read a record into the record buffer lpRecbuf after locating it in the index specified by path using the key in lpKeybuf. The key should be built using KISAMBuildKey. It is the responsibility of the programmer to ensure that the buffer pointed to by lpRecbuf is big enough

If the key is not found in the index the function will return a value of KE_NOTFOUND (1).

If the record is found then its rowid will be returned in the buffer pointed to by lpRowid.