company logo

Property :: nextVersion - Select next instance version

Since instance version numbers are not consecutive, one may select the next higher instance version by calling this function. The function tries to locate the instance with the next higher version number. The function sets the property handle access version to the version number located.

The function returns the version for the selected instance. When no more version is available, the function returns 0xffffffff (maximum unsigned integer value) and the requested version for the instance remains unchanged.

When no instance is selected, or when the database or property handle does not support versioning (e.g. attribute), the function throws an exception.

Notes:

One cannot change instance version for attributes.

Return value:  Instance version number ( uint32  )

Instance version numbers are assigned version numbers to individual instances.

Implementation details

uint32 Property  :: nextVersion (  )