backupDestination (Attribute)



The backupDestination attribute reflects whether this database connection is currently in use as the destination for an online backup.

backupDestination get: When the value of this attribute is true, this database connection is currently in use as the destination database of an online backup. At al other times, the value is false.
backupDestination set: The programmer can not set the value of this attribute. Its value is set internally by ooSQLite.
Remarks: The destination database connection can not be used, by any thread, after the backup is initialized and before the backup is finish . Becasue SQLite does not currently check to see if the application incorrectly accesses the destination database connection, no error code is reported, but the operations may malfunction nevertheless. Use of the destination database connection while a backup is in progress might also cause a mutex deadlock. To prevent this situation, if this database connection is currently in use as the destination for an online backup, this object is locked. Any invocation of anymethodof this object will raise an error condition. Note that allattributesof this object are still accessible. Normally, the programmer would be fully aware of which database connection is currently in use as a destionation database. However, in the event the programmer is not sure of the state of this database connection, thebackupDestinationattribute can be used to determine the state.
Details: This attribute is provided by ooSQLite, there is no applicable API provided by SQLite.