PxIOGetNextPosition

Description

Retrieves the next record's index position

Format

int PxIOGetNextPosition(PxIOFileHandle handle , int keyNumber, uint64_t *position) ;

Where:

handle	The handle of an open file
keyNumber	The key number used to specify whether the key is the primary key or one of the alternate keys (if any). If the value passed is -1, then the key sequence will be based on the one previously used with the file handle. The initial key sequence of a file will be the primary one.
position	A pointer to a uint64_t variable used to save the index position

Return Value

If the function succeeds, a value of PXIO_SUCCESS_STATUS is returned; otherwise, an error value is returned. More information on the nature of the error can be found by calling PxIOGetError.

Note:
This function is equivalent to the PxPlus IND( ) function. If the current record is locked, then the retrieved index position will be that of the current record. Otherwise, it will be that of the record following.