DbEnv::lock_id

APIRef

#include <db_cxx.h>

int DbEnv::lock_id(u_int32_t *idp);

Description

The DbEnv::lock_id method copies a locker ID, which is guaranteed to be unique in the specified lock table, into the memory location referenced by idp.

The DbEnv::lock_id method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on failure, and returns 0 on success.

Errors

If a fatal error occurs in Berkeley DB, the DbEnv::lock_id method will fail and either return DB_RUNRECOVERY or throw an exception encapsulating DB_RUNRECOVERY, at which point all subsequent database calls will fail in the same way.

In addition, the DbEnv::lock_id method may fail and throw an exception or return a non-zero error for errors specified for other Berkeley DB and C library or system methods.

Classes

DbEnv, DbLock

See Also

DbEnv::set_lk_conflicts, DbEnv::set_lk_detect, DbEnv::set_lk_max, DbEnv::lock_detect, DbEnv::lock_get, DbEnv::lock_id, DbLock::put, DbEnv::lock_stat and DbEnv::lock_vec.

APIRef

Copyright Sleepycat Software