PositionVSet

Establish current variable-length ISAM record as current position in set.

Short Name

MIDVSET()

Type

ISAM function

Declaration

COUNT PositionVSet(COUNT keyno, pVOID recptr, COUNT siglen, pVRLEN plen)

Description

PositionVSet() is the same as its fixed-length counter-part, PositionSet(), except that 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 PositionSet() for additional important information.

Return

Value	Symbolic Constant	Explanation
0	NO_ERROR	Successful retrieval of current ISAM record.
633	NPLN_ERR	plen is NULL. No data file read performed.
634	NLEN_ERR	*plen negative on input.

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