Property :: setAccessVersion - Convert Timestamp to instance version
When the instance data type inherits from __OBJECT, instance version may be obtained by timestamp. The function tries to locate the instance version with the maximum timestamp, that is lower or equal than the time stamp passed. The function sets the access version for the property handle to the version number of the located instance.
The function returns the version number for the selected instance (access version). When the data type does not inherit from __OBJECT, or when no instance is selected, the function throws an exception. The function also throws an exception, when the property handle does not support version functions (e.g. for attributes) or when the database does not support versioning (no versioning mode defined).
One cannot change instance version for attributes. One may also not select property version by time stamp, since collection are not time-stamped.
Instance version numbers are assigned version numbers to individual instances.
Implementation overview
- Set Acees version to "last" version
Property :: setAccessVersion (  ) - Set access version to requsted version number
Property :: setAccessVersion ( uVersion ) - Select access version by timestamo
Property :: setAccessVersion ( cDateTime )