SA_AamReadKGP

SA_AamReadKGP allows retrieval of previous records that meet the key criteria for a previous SA_AamReadKG operation.

int SA_AamReadKGP ( 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 must be equal to or larger than the {reclen} parameter specified in SA_AamPrep plus one 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