ObjectSpace :: createVersion - Create new object space version

The function creates a new version on object space level. The database has to be opened in update or write mode. The function returns the version number created. In case of synchronized versioning mode the function creates a new database version and assigns the new version to the object space, i.e. version numbers for an object space may contain gaps. When no versioning mode has been defined so far, versioning mode is set to objectspace scope versioning.

After creating a new version, the access version is set to the created version number. This includes all open property handles.

When the database handle is not valid or versioning mode is not objectspace (also in combination with synchronized or managed ), the function throws an exception.