|
<< Click to Display Table of Contents >> DbiInitRecord |
![]() ![]()
|
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