Product Documentation

FairCom DB API for C

Previous Topic

Next Topic

ctdbFindActiveTableByUID

Get the handle of an active/open table by its unique identifier.

Declaration

CTHANDLE ctdbFindActiveTableByUID(CTHANDLE Handle, ULONG uid)

Description

ctdbFindActiveTableByUID() retrieves the handle of an active/open a table in a database dictionary by the table’s unique identifier.

Use ctdbFindActiveTable() to get the handle of an active/open table by name.

Use ctdbFindTableByUID() to get the name and path of any table in the database dictionary by its Unique identifier.

  • Handle [in] - the handle of the database to be searched.
  • uid [in] - the unique table identifier, used to locate the table. It is set automatically when the table is created.

Returns

ctdbFindActiveTableByUID() returns the table handle or NULL if the specified table is not in the database dictionary or is not active/open.

See also

ctdbFindTableByUID(), ctdbFindActiveTable(), ctdbGetDatabaseUID()

TOCIndex