M

SingleServerService.SetActiveServer

Description:
Set an active server applicable application-wide for the service.

Remarks:

Only one server can be active at any given time in a single-server service, but it is possible that no server is active (unless the service is mandatory).

An application-wide active server gets executed when the service is invoked in the scope of the entire application (i.e. without a specific document), or if the service is executed in a document but the document does not have an active server explicitly set.

It is possible to set a server as active when another server is already active for that service. Making a server active will automatically deactivate the server that was active before this call.

Overloads (2):

SetActiveServer(Guid)

SetActiveServer(Guid,Document)

public void SetActiveServer(
	Guid serverId
)

Public Sub SetActiveServer ( _
	serverId As Guid _
)

public:
void SetActiveServer(
	Guid serverId
)

Guid

serverId

Id of the application server.

Autodesk.Revit.Exceptions.ArgumentException

The given Id is not of a server registered with the service.
Autodesk.Revit.Exceptions.InvalidOperationException

The operation is not allowed because the service is being executed.