Returns a value indicating the update status of the current record if it is part of a batch update (ODBCDirect workspaces only).
Syntax
SHORTGetRecordStatus(VOID);
VOIDSetRecordStatus(SHORT iStatus);
Parameters
Type | Argument | Description |
SHORT | iStatus | A Short with one or more of the values specified in Remarks. |
Remarks
The value of the RecordStatus property indicates whether and how the current record will be involved in the next optimistic batch update, using the following constants:
Constant | Description |
dbRecordUnmodified | (Default) The record has not been modified or has been updated successfully. |
dbRecordModified | The record has been modified and not updated in the database. |
dbRecordNew | The record has been inserted with the AddNew method, but not yet inserted into the database. |
dbRecordDeleted | The record has been deleted, but not yet deleted in the database. |
dbRecordDBDeleted | The record has been deleted locally and in the database. |
When a user changes a record, the RecordStatus for that record automatically changes to dbRecordModified. Similarly, if a record is added or deleted, RecordStatus reflects the appropriate constant. When you then use a batch-mode Update method, DAO will submit an appropriate operation to the remote server for each record, based on the record's RecordStatus property.