Property :: previousVersion - Select previous instance version

Since instance version numbers are not consecutive, one may select the previous (next lower) instance version by calling previousVersion(). The function tries to locate the instance with the next lower 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 property handle is not a reference (generic attribute, reference, relationship or shared base type), the function throws an exception.