4.3.13 ctdbAllocTable

---

Allocate a new table handle.

Declaration

CTHANDLE ctdbAllocTable(CTHANDLE Handle)

Description

ctdbAllocTable allocates memory and initializes a new table handle. Before any operation on the table can take place, the application must allocate a table handle.

Handle [in] the database handle, previously allocated by calling ctdbAllocDatabase.

The database handle is released by calling ctdbFreeTable. Do not release the database handle by calling the C runtime library function free.

Returns

ctdbAllocTable returns the table handle on success or NULL on failure.

Example

CTSESSION_TYPE ctdbsess=CTSESSION_CTDB;

CTHANDLE hSession = ctdbAllocSession(ctdbsess);

CTHANDLE hDatabase = ctdbAllocDatabase(hSession);

CTHANDLE hTable = ctdbAllocTable(hDatabase);

See also

ctdbAllocDatabase, ctdbFreeTable