Advantage Client Engine
Rereads the current record and invalidates the client's read-ahead record cache.
UNSIGNED32 |
AdsRefreshRecord (ADSHANDLE hTable) |
hTable (I) |
Handle of table or cursor. |
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.