Advantage Client Engine
Recalls all deleted records in a table.
UNSIGNED32 |
AdsRecallAllRecords (ADSHANDLE hTable); |
hTable (I) |
Handle of a table. |
AdsRecallAllRecords loops through each record in the given table and recalls all deleted records. This API uses slightly lower level functions and thus can recall more records (for ADTs) than AdsRecallRecord. This operation requires exclusive access to the table, specified during the open. To ensure the integrity of the table header and all associated indexes, AdsRecallAllRecords performs a pack of the table after recalling all deleted records. For this reason, all associated indexes of this table must be opened to remain logically correct. See AdsPackTable for more information.
Note AdsRecallAllRecords can only recall records still in the re-use list (for ADTs). Once a record buffer is re-used, it can never be recalled.