AdsGotoRecord

Advantage Client Engine

Positions the given table to the given record number

Syntax

UNSIGNED32

AdsGotoRecord (ADSHANDLE hTable,

UNSIGNED32 ulRec);

Parameters

hTable (I)

Handle of table or cursor.

ulRec (I)

Record number.

Remarks

AdsGotoRecord ignores filters, relations, and scopes. If ulRec is zero, the client will be unpositioned (EOF and BOF will be set), and the current record number will be set to 0. If ulRec is greater than the number of records in the table, the client will be unpositioned (EOF and BOF will be set), and the current record number will be set to the number of records in the table + 1.

Note Explicitly moving to a deleted record when using the Advantage proprietary table format (ADT) is an illegal operation and will return the error 5022 (AE_INVALID_RECORD_NUMBER), invalid record number.

Example

Click Here

See Also

AdsGotoBottom

AdsGotoTop

AdsGetRecordNum

AdsGetRecordCount

AdsSkip

AdsWriteRecord