company logo

Property :: updateVersion - Update instance version

When the versioning mode is database or synchronized, one may update the current version of the owner scope for the selected instance or collection to the version number passed in uVersion. When the version number passed in uVersion is 0xFFFFFFFF (maximum unsigned 32 bit value), the version is set to the access version defined for the object space. When no access version has been set for the object space, the version number is set to the last version number defined for the database.

When the property handle is not a scope owner (global instance for owner scope or local instance for instance scope versioning), the function searches the scope owning instance in order to change the scope version, i.e. one may call the function also for subordinated property handles.

When no instance is selected, when the scope version is larger than the version number passed in uVersion or when uVersion is greater than the last version number created for the data base, the function throws an exception. The function also throws an exception, when the version mode defined for the database does not support updating versions (not synchronized versioning)

Implementation details

Property  :: updateVersion ( uint32 uVersion )
  • uVersion - Instance version number

    Instance version numbers are assigned version numbers to individual instances.