AdsDeleteRecord

Advantage Client Engine

  This is the first topic This is the last topic  

Marks the current record in the given table as deleted.

Syntax

UNSIGNED32

AdsDeleteRecord (ADSHANDLE hTable);

Parameters

hTable (I)

Handle of table or cursor.

Remarks

In DBF tables, AdsDeleteRecord does not actually remove the current record from the table. The record is marked in the first byte of the record image as deleted. The record can be recalled using AdsRecallRecord. Query the deleted status of a record by using AdsIsRecordDeleted. Deleted records can be removed from tables completely by using AdsPackTable.

In Advantage proprietary ADT tables, AdsDeleteRecord will permanently delete the current record. The record cannot be recalled using AdsRecallRecord after the record has been written.

Note Deleted ADT records are automatically placed in a record re-use list. Because of this, the server unlocks them even if the user has an explicit lock on the record.

Example

Click Here

See Also

AdsRecallRecord

AdsIsRecordDeleted

AdsPackTable

AdsAtEOF