DbiInitRecord

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

DbiInitRecord

Return to chapter overview

C syntax

DBIResult DBIFN DbiInitRecord (hCursor, pRecBuf);

Delphi syntax

function DbiInitRecord (hCursor: hDBICur; pRecBuff: Pointer): DBIResult stdcall;

Description

DbiInitRecord initializes a record buffer. This operation is required before composing a new record for insertion.

Parameters

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

pRecBuf                Type: pBYTE                (Output)
Pointer to the client buffer that receives the initialized record buffer.

Usage

DbiInitRecord initializes the record buffer to a blank record according to the data types of the fields.

Paradox: If the table has associated default values with any of the fields, the default values are used to initialize the fields.

Completion state

The record buffer contains blank fields or default values. The position of the given cursor is not affected. The client application can use the BDE field-level functions to fill the record buffer with the appropriate values.

DbiResult

Meaning

DBIERR_NONE

The initialization was successful.

DBIERR_INVALIDHNDL

The specified cursor handle is invalid or NULL.

DBIERR_INVALIDPARAM

The specified record buffer is NULL.

See also

DbiAppendRecord, DbiGetRecord, DbiGetNextRecord, DbiGetPriorRecord, DbiModifyRecord, DbiInsertRecord, DbiPutField, DbiSetToKey, DbiGetBlob, DbiPutBlob, DbiOpenBlob, DbiFreeBlob, DbiGetField