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.