FairCom DB API for C

ctdbFindActiveTable

Get the handle of an active table by name.

Declaration

CTHANDLE ctdbFindActiveTable(CTHANDLE Handle, pTEXT Name)

where:

• Handle [in] - the handle of the database dictionary to search.
• Name [in] - the string with the table name to lookup in the database dictionary.

Description

ctdbFindActiveTable() retrieves the table handle of an active/open table in the given database dictionary by name.

To get the handle of an active table by the Unique Identifier, use ctdbFindActiveTableByUID().

To retrieve the table handle of the first active table in the database dictionary, use ctdbGetFirstActiveTable().

To get the path of any table in the database dictionary by name, use ctdbFindTable().

Returns

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

See also

ctdbFindActiveDatabaseByUID(), ctdbFindTable(), ctdbGetFirstActiveTable()