#include <db.h>

int db_sequence_create(DB_SEQUENCE **seq, DB *db, u_int32_t flags);  

Creates a sequence handle, which can then be opened with DB_SEQUENCE->open() .

DB_SEQUENCE handles are free-threaded if the DB_THREAD flag is specified to the DB_SEQUENCE->open() method when the sequence is opened. Once the DB_SEQUENCE->close() or DB_SEQUENCE->remove() methods are called, the handle can not be accessed again, regardless of the method's return.

Each handle opened on a sequence may maintain a separate cache of values which are returned to the application using the DB_SEQUENCE->get() method either singly or in groups depending on its delta parameter.

Calling the DB_SEQUENCE->close() or DB_SEQUENCE->remove() methods discards this handle.

db_sequence_create() method returns a non-zero error value on failure and 0 on success.