DbiGetRecordCount

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

DbiGetRecordCount

Return to chapter overview

C syntax

DBIResult DBIFN DbiGetRecordCount (hCursor, piRecCount);

Delphi syntax

function DbiGetRecordCount (hCursor: hDBICur; var iRecCount: Longint): DBIResult stdcall;

Description

DbiGetRecordCount is used to get the current number of records associated with the cursor.

Parameters

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

piRecCount                Type: pUINT32                (Output)
Pointer to the client variable which receives the number of records associated with the cursor. This number may be approximate.

Usage

This function is meant to get the number of records associated with the cursor. The count is approximate in some cases, rather than exact. (If there are any active filters associated with the cursor, or if there are any active ranges declared on it, the results are approximate; they are normally the upper limits.)

Paradox: If a range is active, the record count returned is the number of records in the range.

DbiResult

Meaning

DBIERR_NONE

The record count was retrieved successfully.

DBIERR_INVALIDHNDL

The specified cursor handle is invalid or NULL.

See also

DbiGetExactRecordCount