PVK_seek( ): Position Within a File

Format

int PVK_seek(int fh, char *keybfr, int keysz, int keyno);

Where:

fh	File handle returned from a prior call to PVK_OpenExt( )
keybfr	Pointer to a buffer containing the key
keysz	Size of the key in bytes
keyno	Key number to use (0 = Current key, 1 = Primary, 2 = First alternate, etc.)

Description

PVK_seek( ) is used to position the key pointer to a specified location within a file for subsequent processing. By default, the Key IO routines read using the primary access key (KEY 1). An alternate key chain may be specified in the keyno parameter.

If keyno is set to 0, the current key is used. If successful, a status of 0 is returned.