C-Library File IO Routines

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.