M

WorksharingUtils.RelinquishOwnership

Description:
Relinquishes ownership by the current user of as many specified elements and worksets as possible, and grants element ownership requested by other users on a first-come, first-served basis.

Remarks:

Elements and worksets owned by other users are ignored.

Only unmodified elements already in central will be relinquished by this method. Newly added and modified elements cannot be relinquished until they have been synchronized with central.

For best performance, relinquish items in one big call, rather than many small calls.

public static RelinquishedItems RelinquishOwnership(
	Document document,
	RelinquishOptions generalCategories,
	TransactWithCentralOptions options
)

Public Shared Function RelinquishOwnership ( _
	document As Document, _
	generalCategories As RelinquishOptions, _
	options As TransactWithCentralOptions _
) As RelinquishedItems

public:
static RelinquishedItems^ RelinquishOwnership(
	Document^ document, 
	RelinquishOptions^ generalCategories, 
	TransactWithCentralOptions^ options
)

Autodesk.Revit.DB.Document

document

The document containing the elements and worksets.
Autodesk.Revit.DB.RelinquishOptions

generalCategories

General categories of items to relinquish. See RelinquishOptions for details.
Autodesk.Revit.DB.TransactWithCentralOptions

options

Options to customize access to the central model. nulla null reference (Nothing in Visual Basic) is allowed and means no customization.

Return Value RelinquishedItems The elements and worksets that were relinquished.

Autodesk.Revit.Exceptions.ArgumentException

document is not a workshared document. -or- document is not a primary document, it is a linked document. -or- document is read-only: It cannot be modified. -or- document has an open editing transaction and is accepting changes. -or- Saving is not allowed in the current application mode.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was null
Autodesk.Revit.Exceptions.CentralFileCommunicationException

The file-based central model could not be reached, e.g. the network is down or the file server is down.
Autodesk.Revit.Exceptions.CentralModelAccessDeniedException

Access to the central model was denied due to lack of access privileges. -or- Access to the central model was denied. A possible reason is because the model was under maintenance.
Autodesk.Revit.Exceptions.CentralModelContentionException

The central model is locked by another client.
Autodesk.Revit.Exceptions.CentralModelException

The central model is overwritten by other user. -or- The central model is missing. -or- An internal error happened on the central model, please contact the server administrator.
Autodesk.Revit.Exceptions.InvalidOperationException

Operation is not permitted when there is any open sub-transaction, transaction, or transaction group.
Autodesk.Revit.Exceptions.RevitServerCommunicationException

The server-based central model could not be accessed because of a network communication error.
Autodesk.Revit.Exceptions.RevitServerInternalException

An internal error happened on the server, please contact the server administrator.