4.3.85 ctdbFindDatabase

---

Locate a database by name.

Declaration

CTDBRET ctdbFindDatabase(CTHANDLE Handle, pTEXT Name, pTEXT Path,

VRLEN PathSize)

Description

ctdbFindDatabase locates a database by name. Use ctdbFindDatabaseByUID to locate a database by its unique identifier. Use ctdbFindActiveDatabase to find an active database by name.

Handle [in] the session handle.
Name [in] the string with the database name to lookup in the session.
Path [out] receives the database path, if the name is located and it is large enough to hold the path.
PathSize [in] the size in bytes of Path. If Path is not large enough to receive the database path, ctdbFindDatabase will return CTDBRET_ARGSMALL.

Returns

ctdbFindDatabase returns CTDBRET_OK on success, or the c-tree Plus error code on failure.

Example

eRet = ctdbLogon(hSession, "FAIRCOMS", "ADMIN", "ADMIN");

eRet = ctdbFindDatabase(hSession, db_name, db_path, sizeof(db_path));

See also

ctdbFindDatabaseByUID, ctdbFirstDatabase, ctdbNextDatabase, ctdbFindActiveDatabase