ArcObjects Library Reference (Server)

IServerObjectManager Interface

Provides access to properties and members of the ArcGIS server's server object manager.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

When To Use

Use the IServerObjectManager interface when your application connects to the ArcGIS Server to use and create server objects. For performing administration tasks, such as adding and removing server object configurations, use the IServerObjectAdmin interface.

Members

		Description
	CreateServerContext	Gets a reference to a server context. The server context can be based on a specified server object configuration, or can be an empty server context if no server object configuration is specified.
	GetConfigurationInfo	Gets the ServerObjectConfigurationInfo for the specified Name and TypeName.
	GetConfigurationInfos	An enumerator over all the GIS server's ServerObjectConfigurationInfos.
	GetServerDirectoryInfos	An enumerator over all the GIS server's ServerDirectoryInfos.
	GetTypeInfos	An enumerator over all the GIS server's ServerObjectTypeInfos.

CoClasses that implement IServerObjectManager

CoClasses and Classes	Description
ServerObjectManager	The ServerObjectManager object which creates ServerContext, ServerObjectConfigurationInfo and ServerObjectTypeInfo objects.

Remarks

Any application that runs as a user account in the agsusers user group on the ArcGIS Server can use the IGISServerConnection interface to connect to the ArcGIS Server and to get a reference to the ServerObjectManager.

The IServerObjectManager interface has the necessary methods for an application to get the collection of server object configurations and server object types configured in the server as ServerObjectConfigurationInfo and ServerObjectTypeInfo objects, respectivly. These Info objects provide information about the server object configurations and types required to make use of them in an application. Additional information about server object configurations and server object types configured in the server can be accessed using the IServerObjectAdmin interface.

The CreateServerContext method on IServerObjectManager is used to get a reference to a context on the server. A context is a process managed by the server within which a server object runs. You can use CreateServerContext to create a context based on a server object configuration, or you can create empty contexts soley for the purpose of creating ArcObjects on the fly within the server.

When using CreateServerContext to create a context based on a server object configuration, if the server object configuration is pooled, you may get a reference to a context that is already created and running in the server. When you have completed using that context, it is important to released it explicitly by calling the ReleaseContext method on IServerContext to return it to the pool. When using CreateServerContext to create a context based on a non-pooled server object configuration, or when creating an empty context, a new context is created on the server. You still need to call ReleaseContext when you are finished using it, and the context is destroyed on the server.