Status Property

Indicates the status of the current record with respect to batch updates or other bulk operations.

Return Values

Returns a sum of one or more of the following RecordStatusEnum values:

Constant	Value	Description
adRecOK	0	The record was successfully updated.
adRecNew	1	The record is new.
adRecModified	2	The record was modified.
adRecDeleted	4	The record was deleted.
adRecUnmodified	8	The record was not modified.
adRecInvalid	16	The record was not saved because its bookmark is invalid.
adRecMultipleChanges	64	The record was not saved because it would have affected multiple records.
adRecPendingChanges	128	The record was not saved because it refers to a pending insert.
adRecCanceled	256	The record was not saved because the operation was canceled.
adRecCantRelease	1024	The new record was not saved because of existing record locks.
adRecConcurrencyViolation	2048	The record was not saved because optimistic concurrency was in use.
adRecIntegrityViolation	4096	The record was not saved because the user violated integrity constraints.
adRecMaxChangesExceeded	8192	The record was not saved because there were too many pending changes.
adRecObjectOpen	16384	The record was not saved because of a conflict with an open storage object.
adRecOutOfMemory	32768	The record was not saved because the computer has run out of memory.
adRecPermissionDenied	65536	The record was not saved because the user has insufficient permissions.
adRecSchemaViolation	131072	The record was not saved because it violates the structure of the underlying database.
adRecDBDeleted	262144	The record has already been deleted from the data source.

Remarks

Use the Status property to see what changes are pending for records modified during batch updating. You can also use the Status property to view the status of records that fail during bulk operations such as when you call the Delete, Resync, UpdateBatch, or CancelBatch methods on a Recordset object, or set the Filter property on a Recordset object to an array of bookmarks. With this property, you can determine how a given record failed and resolve it accordingly.

Applies To

Recordset