JetCloseTable Function

Applies to: Windows | Windows Server

JetCloseTable Function

The JetCloseTable function closes an open table in a database. The table may be a temporary table or a normal table.

JET_ERR JET_API JetCloseTable(
  __in          JET_SESID sesid,
  __in          JET_TABLEID tableid
);

Parameters

sesid

Identifies the database session context that will be used for the API call.

tableid

Identifies the table to be closed.

Set tableid to JET_tableidNil to release memory.

Return Value

This function returns the JET_ERR datatype with one of the following return codes. For more information about the possible ESE errors, see Extensible Storage Engine Errors and Error Handling Parameters.

Remarks

This function must be called on all tables opened with JetOpenTable.

The exception to this rule happens when JetOpenTable is called in a transaction and the transaction is rolled back (with JetRollback). When rolling back a transaction, the table is automatically closed. In this case, it is an error to close the table with JetCloseTable.

Requirements

See Also

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetOpenTable
JetRollback