Advantage TDataSet Descendant
Positions the given table to the given bookmark.
procedure AdsGotoBookmark( hBookmark : Longint );
|
hBookmark |
Bookmark from a call to AdsGetBookmark. |
CAUTION It is recommended that this Advantage extended method not be used. Please read the Caution About Extended Methods for more information. The suggested native Delphi method to use instead is: GotoBookmark. See your Delphi documentation for more information about this native Delphi method.
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.
AdsTable1.FindKey( [‘Smith’] );
oBookMark := AdsTable1.GetBookmark;
AdsTable1.Next;
AdsTable1.GotoBookmark( oBookMark );