DbiCreateTempTable

C syntax

DBIResult DBIFN DbiCreateTempTable (hDb, pcrTblDsc, phCursor);

Delphi syntax

function DbiCreateTempTable (hDb: hDBIDb; var crTblDsc: CRTblDesc; var hCursor: hDBICur): DBIResult stdcall;

Description

DbiCreateTempTable creates a temporary table that is deleted when the cursor is closed, unless the call is followed by a call to DbiMakePermanent or DbiSaveChanges.

Parameters

hDb Type: hDBIDb (Input)
Specifies the database handle. When a NULL hDb is specified, all temp tables will be created in the default working directory of the current session (the location of BDE executable or explicitly set by using DbiSetDirectory)--unless a private directory has been explicitly set on the current session by using DbiSetPrivateDir.

pcrTblDsc Type: pCRTblDesc (Input)
Pointer to the table descriptor structure (CRTblDesc). Usage is the same as in DbiCreateTable except that referential integrity cannot be created for a temporary table. Refer to DbiGetFieldTypeDesc and DbiGetIndexTypeDesc for more information on the legal values for these structures for each Borland Database Engine driver.

phCursor Type: phDBICur (Output)
Pointer to the cursor handle for the table.

Usage

Physical as well as logical field types are supported by the temporary table.

SQL: This function is not supported with SQL tables.

DbiResult	Meaning
DBIERR_NONE	The table was created successfully.