Advantage Client Engine
Determines the deleted status of the current record in a DBF table.
UNSIGNED32 |
AdsIsRecordDeleted (ADSHANDLE hTable, UNSIGNED16 *pbDeleted); |
hTable (I) |
Handle of table or cursor. |
pbDeleted (O) |
Return True if the current record is marked for deletion, False if not. |
AE_NO_CURRENT_RECORD |
Data cannot be retrieved from EOF or BOF |
The first byte of every record in a DBF table is reserved for use as a deleted byte. This byte signals whether the record is deleted and/or encrypted. The result of this function can be used to implement a recycling algorithm for deleted records, or a periodic AdsPackTable can be used to remove deleted records from the table.
Note AdsIsRecordDeleted will generally return False in the pbDeleted parameter for Advantage proprietary ADT tables. Records that are deleted in ADT tables are permanently deleted and can never be retrieved by a client application once they have been written. It is possible to call AdsIsRecordDeleted just after calling AdsDeleteRecord and before the record is written. This function will return True in that case.