AdsGotoBookmark

Advantage Client Engine

Positions the given table to the given bookmark

Syntax

UNSIGNED32

AdsGotoBookmark (ADSHANDLE hTable,

ADSHANDLE hBookmark);

Parameters

hTable (I)

Handle of table or cursor.

hBookmark (I)

Bookmark from a call to AdsGetBookmark.

Remarks

This function is equivalent to AdsGotoRecord. Currently, hBookmark as returned from AdsGetBookmark is the record number.

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.

 

Note This function is capable of utilizing registered callback functions. To learn more about callback functionality and how it behaves with this function, see Callback Functionality.

Example

Click Here

See Also

AdsGetBookmark

AdsGotoRecord