IVersionCol::Add
See Also
Adds an object version to the collection.
HRESULT Add(
IRepositoryObjectVersion *pIReposVersion
);
Parameters
*pIReposVersion
[in]
The IRepositoryObjectVersion interface pointer to the object version to be added to the collection.
Return Value
S_OK
The method completed successfully.
Error
Values
This method failed to complete successfully.
Remarks
There are many different kinds of Object-Version collections. You can apply this method to some of them, but not to others. This method works for:
-
Target-Versions collections. You can use this method to enlarge the set of versions of a particular target object that are related to a particular source object.
-
Versions-of-Workspace collections. You can use this method to add an object version to the set of items contained in the workspace.
This method does not work for:
-
Predecessor-Versions collection. To enlarge an object version’s set of predecessors, use the MergeVersion method of the IRepositoryObjectVersion interface.
-
Successor-Versions collection. To enlarge an object version’s set of successors, use the CreateVersion method of the IRepositoryObjectVersion interface.
-
Versions-of-Object collection. To enlarge an object’s set of versions, use the CreateVersion method of the IRepositoryObjectVersion interface.
-
Workspaces-of-Version collection. To enlarge the set of workspaces to which an object version belongs, you do not add a workspace to an object version—rather you add the object version to a workspace. In other words, you use the Add method of the IVersionCol interface, but the version collection you are manipulating is the Versions-of-Workspace collection, not the Workspaces-of-Version collection.
-
Checkouts-of-Workspace collection To check out another item to a workspace, use the Checkout method of the IWorkspaceItem interface.