AdsRefreshRecord

Advantage Client Engine

Rereads the current record and invalidates the client's read-ahead record cache.

Syntax

UNSIGNED32

AdsRefreshRecord (ADSHANDLE hTable)

Parameters

hTable (I)

Handle of table or cursor.

Remarks

AdsRefreshRecord will force all records that are currently stored in the client's read-ahead record cache to be purged. This function is useful if it is likely that another user has updated the current record stored in the read-ahead cache, and you wish your application to see the new data that was updated in this record. When it is not possible for another user to have updated the current record (because the record is locked, the table is locked, or the table is opened exclusively), AdsRefreshRecord will do nothing. If the record to be refreshed has been modified by the user calling the AdsRefreshRecord API but has not yet been flushed to the server, AdsRefreshRecord will fail and return the error AE_PENDING_UPDATE. To cancel the pending update, use AdsCancelUpdate.

Example

Click Here

See Also

AdsCancelUpdate

AdsLockRecord