NAME
dfindpk - find previous record with same key
SYNOPSIS
#include <cbase/dirio.h>
rno_t dfindpk (buffer, fcb)
char *buffer;
DFILE *fcb;
DESCRIPTION
Dfindpk finds the previous occurrence of a keyed record in an opened RMSfile. Dfindlk(C-3) must be called to find the last occurrence of a keyed record. After that call, multiple calls to dfindpk may be made to retrieve previous occurrences of a keyed record. The beginning contents of buffer are ignored by dfindpk.
Fcb is the file block pointer returned by dlopen(C-3) or dopen(C-3).
The returned record number may be saved and used on a subsequent call to dread(C-3). The record found is returned in buffer.
SEE ALSO
dlopen(C-3), dopen(C-3), dread(C-3), dfindlk(C-3)
Chapter 4,
RMS Programming Guide
DIAGNOSTICS
Dfindpk returns a value of BAD (-1) if the record is not found or if an I/O error occurred. If the record is not found then the contents of buffer are undefined.