<< Click to Display Table of Contents >> Navigation:  »No topics above this level« DbiMakePermanent

C syntax

DBIResult DBIFN DbiMakePermanent (hCursor, [pszName], bOverWrite);

Delphi syntax

function DbiMakePermanent (hCursor: hDBICur; pszName: PChar; bOverWrite: Bool): DBIResult stdcall;

Description

DbiMakePermanent changes a temporary table created by DbiCreateTempTable into a permanent table, optionally renaming it using pszName.

Parameters

hCursor                Type: hDBICur                (Input)
Specifies the cursor handle.

pszName                Type: pCHAR                (Input)
Pointer to the name of the permanent table.

bOverWrite                Type: BOOL                (Input)
If set to TRUE, overwrites the existing file.

Usage

This function is used to change a temporary table, created with DbiCreateTempTable, into a permanent table, that is, one that will not be deleted when the cursor is closed with DbiCloseCursor. DbiSaveChanges can also be used to make the temporary table permanent, but the table is flushed out to disk immediately. With DbiMakePermanent, buffers are flushed to disk when convenient, or when the cursor is closed. The table is renamed to pszName if different from NULL.

SQL: This function is not supported by SQL drivers.

Prerequisites

A temporary table must have been created with DbiCreateTempTable.

Completion state

The table is saved to disk when the cursor is closed.

See also

DbiSaveChanges, DbiCreateTempTable, DbiCloseCursor, DbiQInstantiateAnswer