JetCloseTable Function

Article
08/26/2021

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.

Return code	Description
JET_errSuccess	The operation completed successfully.

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

Requirement	Value
Client	Requires Windows Vista, Windows XP, or Windows 2000 Professional.
Server	Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server.
Header	Declared in Esent.h.
Library	Use ESENT.lib.
DLL	Requires ESENT.dll.

JetCloseTable Function