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. |
See Also
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetOpenTable
JetRollback
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
