Library Version 12.1.6.2

DB_MULTIPLE_RECNO_NEXT
Prev | Chapter 4. The DBT Handle | Next

## 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.

### Class

DBT

### See Also

DBT and Bulk Operations

Prev | Up | Next
DB_MULTIPLE_KEY_NEXT | Home | DB_MULTIPLE_WRITE_INIT