Previous Topic

Next Topic

GetLTEVRecord

Read the variable-length record with key less than or equal to target.

Short Name

LTEVREC()

Type

ISAM function

Declaration

COUNT GetLTEVRecord(COUNT keyno, pVOID target, pVOID recptr, pVRLEN plen)

Description

GetLTEVRecord() is the same as its fixed-length counterpart, GetLTERecord(), except one argument has been added: plen acts as both an input and output parameter. On input, *plen contains the length of the output buffer. On output, *plen contains the actual data record length. If the length of the output buffer is less than the actual record length, a partial read is performed.

Read the function description for GetLTERecord() for additional important information.

Return

Value

Symbolic Constant

Explanation

0

NO_ERROR

Successful retrieval of current ISAM record.

633

NPLN_ERR

recptr is NULL. No data file read performed.

634

NLEN_ERR

Could not lock data record. No data file read performed.

See c-tree Plus Error Codes for a complete listing of valid c-tree Plus error values.

See also

GetGTEVRecord(), GetGTVRecord(), GetLTVRecord(), TransformKey()