DbiBeginDelayedUpdates

C syntax

DBIResult DBIFN DbiBeginDelayedUpdates (phCursor);

Delphi syntax

function DbiBeginDelayedUpdates (var hCursor: hDBICur): DBIResult stdcall;

Description

DbiBeginDelayedUpdates converts a cursor to a cached updates cursor. Given an open cursor, prepares for cached updates. Returns a new cursor; the old cursor is no longer valid.

Parameters
phCursor	Type: phDBICur	(Input/Output)
On input, specifies the original cursor. On output, returns the new cursor; the old cursor is no longer valid.

Usage

Use DbiBeginDelayedUpdates to activate the cached updates mode. This feature lets you retrieve data from a table and make changes to that temporarily cached data without immediately writing to the actual underlying table. You can make changes over a prolonged period with a minimum amount of resource locking at the actual database. After modifying the data, call DbiApplyDelayedUpdates to save changes in the actual table.

Prerequisites

None

Completion state

The record buffer (RecBuffsize) and the bookmark (BookMarksize) increase in size upon completion of DbiBeginDelayedUpdates. You should call DbiGetCursorProps and reallocate memory properties for bookmark and record buffers accordingly.

DbiResult	Meaning
DBIERR_NONE	The cached updates mode was initiated and the new cached updates cursor handle was successfully created.