4.3.86 ctdbFindDatabaseByUID

---

Locate a database by its unique identifier.

Declaration

CTDBRET ctdbFindDatabaseByUID(CTHANDLE Handle, ULONG uid, pTEXT Name,

VRLEN NameSize, pTEXT Path, VRLEN PathSize)

Description

ctdbFindDatabaseByUID locates a database in a session by its unique identifier. Use ctdbFindDatabase to find a database by name. Use ctdbGetDatabaseUID to retrieve the database UID.

Handle [in] the session handle.
uid [in] the unique database identifier, used to locate the database. It is set automatically when the database is created.
Name [out] the string with the database name.
NameSize [in] the size in bytes of Name. If Name is not large enough to receive the database name, ctdbFindDatabaseByUID will return CTDBRET_ARGSMALL.
Path [out] the database path, if the name is located and it is large enough to hold the path. The path includes drive, directory, filename and file extension.
PathSize [in] the size in bytes of Path. If Path is not large enough to receive the database path, ctdbFindDatabaseByUID will return CTDBRET_ARGSMALL.

Returns

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

See also

ctdbFindDatabase, ctdbGetDatabaseUID