DbiQExec

C syntax

DBIResult DBIFN DbiQExec (hStmt, phCur);

Delphi syntax

function DbiQExec (hStmt: hDBIStmt; phCur: phDBICur): DBIResult stdcall;

Description

DbiQExec executes the previously prepared query identified by the supplied statement handle and returns a cursor to the result set, if one is generated.

Parameters

hStmt Type: hDBIStmt (Input)
Specifies the statement handle.

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

Usage

This function is used to execute a prepared query. If the query returns a result set, the cursor handle to the result set is returned into the address given by phCur. If the query does not generate a result set, the returned cursor handle is zero. If no cursor handle address is given and a result set would be returned, the result set is discarded.

The same prepared query can be executed several times, but only after the returned cursor has been closed.

DbiResult	Meaning
DBIERR_NONE	The prepared query was executed successfully.
DBIERR_MULTIRESULTS	Query returned multiple result sets.