DbiSetToEnd

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

DbiSetToEnd

Return to chapter overview

C syntax

DBIResult DBIFN DbiSetToEnd (hCursor);

Delphi syntax

function DbiSetToEnd (hCursor: hDBICur): DBIResult stdcall;

Description

DbiSetToEnd positions the cursor at the end of the result set.

Parameters

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

Usage

This function is used to reposition the cursor at the end of the result set. DbiGetPriorRecord or DbiGetRelativeRecord can be called to position the cursor on the last valid record of the result set.

Completion state

The cursor is positioned on the crack after the end of the result set. There is no current record after DbiSetToEnd completes. (DbiGetRecord returns DBIERR_EOF.)

DbiResult

Meaning

DBIERR_NONE

The cursor was successfully set to the EOF position.

DBIERR_INVALIDHNDL

The specified cursor handle is invalid or NULL.

See also

DbiSetToBegin, DbiGetNextRecord, DbiGetPriorRecord, DbiGetRelativeRecord, DbiSetToCursor