DB_MULTIPLE_RECNO_NEXT
#include <db.h>
DB_MULTIPLE_RECNO_NEXT(void *pointer, DBT *data,
db_recno_t recno, void * retdata, size_t retdlen); If either of the DB_MULTIPLE or DB_MULTIPLE_KEY flags were specified to the DB->get() or DBcursor->get() methods, the data DBT returned by those interfaces will refer to a buffer that is filled with data. Access to that data is through the DB_MULTIPLE_* macros.
Returns the next DBT in the bulk retrieval set. Use this macro with DBT structures obtained from a database that uses the Queue or Recno access methods.
Parameters
pointer
The pointer parameter is a variable that must have been initialized by a call to DB_MULTIPLE_INIT.
This parameter is set to NULL if there are no more key/data pairs in the returned set.
data
The data parameter is a DBT structure returned from a successful call to DBcursor->get() with the Queue or Recno access methods for which the DB_MULTIPLE_KEY flag was specified.
The data parameter must have been initialized by a call to DB_MULTIPLE_INIT.
recno
The recno parameter is set to the record number of the next record in the returned set.
retdata
The retdata parameter is set to the next data element in the returned set. Deleted records are not included in the results.
retdlen
The retdlen parameter is set to the length, in bytes, of the next data element.