SA_IsiInsert

SA_IsiInsert writes an index record key associated with the last record read or written into a secondary index file.

int SA_IsiInsert ( SA_FH IsiFH, u8 *Key, u16 KeyLen );

Parameters:

IsiFH

The handle of the previously opened or prepared ISAM file.

Key

Text that must match to qualify this record for subsequent read operations.

KeyLen

The length of the text in {Key}.

Note the following:

1. The text in key should match the corresponding positions in buffer that were defined for the key information. If the key positions were defined as '21-25,3-7', positions 1-5 of key should match positions 21-25 of buffer and positions 6-10 of key should match positions 3-7 of buffer. If they do not match, the record will not be retrievable with this key after the file has been re-indexed with the Sunindex utility.

2. Function return codes are as follows:

 

Value	Meaning
1	Success.
-nn	Error as described in Sunaccess Errors