DbiSetToCursor

C syntax

DBIResult DBIFN DbiSetToCursor (hDest, hSrc);

Delphi syntax

function DbiSetToCursor (hDest: hDBICur; hSrc: hDBICur): DBIResult stdcall;

Description

DbiSetToCursor sets the position of one cursor (the destination cursor) to the position of the source cursor.

Parameters

hDest Type: hDBICur (Input)
Specifies the destination cursor handle.

hSrc Type: hDBICur (Input)
Specifies the source cursor handle.

Usage

This function synchronizes the position of two cursors on the same table.

Prerequisites

Source and destination cursors must be opened on the same table in the same session, and both must be valid. If both cursors are opened on a single table, they do not have to have the same current index. The source cursor must have a current record if the index order is different.

Completion state

After DbiSetToCursor executes, the destination cursor is positioned on the same record as the source cursor. They remain independent of each other, they do not track each other.

DbiResult	Meaning
DBIERR_NONE	The destination cursor was successfully set to the record of the source cursor.
DBIERR_INVALIDHNDL	The specified source cursor or destination cursor is invalid or NULL.
DBIERR_NOCURRREC	The source cursor has no current record.
DBIERR_NOTSAMESESSION	The source and destination cursors are not opened in the same session.