DbiQInstantiateAnswer

C syntax

DBIResult DBIFN DbiQInstantiateAnswer ( hStmt, [hCursor], pszAnswerName,pszAnswerType, bOverWrite, phDstCursor )

Delphi syntax

function DbiQInstantiateAnswer (hStmt: hDBIStmt; hCur: hDBICur; pszAnswerName: PChar; pszAnswerType : PChar; bOverWrite: Bool; var phCur: phDBICur): DBIResult stdcall;

Description

DbiQInstantiateAnswer creates an ANSWER table of type PARADOX or DBASE. The flags pszAnswerName and pszAnswerType may be used in renaming and changing the type respectively. If the flag bOverWrite is set to TRUE, then it will overwrite the existing pszAnswerTable.

Parameters

hStmt Type: hDBIStmt (Input)
Specifies the statement handle

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

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

pszAnswerType Type: pCHAR (Input)
Pointer to the name of the driver type.

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

phDstCursor Type: phDBICur (Output)
Pointer to the cursor handle.

Usage

DbiQInstantiateAnswer is used to create a permanent table from a cursor handle. The table name is ANSWER.DB by default or it will create pszAnswerName with pszAnswerType. You can use the bOverWrite flag to overwrite the existing pszAnswerTable.

Prerequisites

A statement handle must be allocated with DbiQAlloc.

Completion state

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

DbiResult	Meaning
DBIERR_NONE	The temporary table has been designated as a permanent table.