SA_AamReadKG

SA_AmReadKG allows retrieval of subsequent records that met the key criteria for a previous SA_AamRead operation.

int SA_AamReadKG ( SA_FH AamFH, u8 *Buffer, u32 BufLen );

Parameters:

AamFH

The handle of the previously opened or prepared AAM file.

Buffer

The buffer to be filled by the operation.

BufLen

The length of the {Buffer}.

Note the following:

1. The buffer length {BufLen} must be equal to or larger than the {reclen} parameter specified in SA_AamPrep plus one (1) for null termination.

2. A null buffer pointer will allow positioning to the indicated record without actually reading it.

3. Function return codes are as follows:

 

Value	Meaning
nn	Length of the data read + 1.
0	No more records meeting this key specification.
-nn	Error as described in Sunaccess Errors