int KISAMReadHoldNext(KHAND handle, int path, char *lpRecbuf, char *lpKeybuf, ROWID lpRowid)
| Parameter | Type | Purpose |
| handle | KHAND | handle of table |
| path | int | index path being followed. This must have been established in a previous start operation. |
| lpRecbuf | char * | record buffer to receive the next 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 row copied into the record buffer. |
This performs a KISAMReadNext function and, if successful, it locks the row ready for a subsequent update or delete. The row will stay locked until updated or until explicitly unlocked by KISAMUnlock. It will fail with KE_LOCKED (12) if the row is already locked by another process.