FairCom DB API for C

ctdbGetNextActiveTable

Retrieve the handle of the next active/open table in the database dictionary.

Declaration

CTHANDLE ctdbGetNextActiveTable(CTHANDLE Handle, pVRLEN pScanRec)

Description

ctdbGetNextActiveTable() retrieves the handle of the next active/open table in the database dictionary. Obtain the handle of the first active/open table in the database with ctdbGetFirstActiveTable() before requesting the handle of the next active table in the database with this function.

• Handle [in] the Database Handle.
• pScanRec [out] the pointer to a VRLEN to hold the scan state. It is first returned by ctdbGetFirstActiveTable(), and it is updated in the ctdbGetNextActiveTable() function.

Returns

ctdbGetNextActiveTable() returns the database handle, or NULL if the handle of the last active/open table in the database dictionary has already been retrieved.

See also

ctdbAllocSession(), ctdbGetFirstActiveTable(), ctdbFindActiveTable()