This document is archived and information here might be outdated. Recommended version. |
ArcObjects Help for .NET developers > ArcObjects namespaces > Server > ESRI.ArcGIS.Server > Interfaces > IS > IServerObjectConfiguration Interface (ArcObjects .NET 10.5 SDK) |
Provides access to administrators to members that control the behavior and properties of a server object configuration.
Use the IServerObjectConfiguration interface to do the following:
Define a new server object configuration to be added to the server with the AddConfiguration method on IServerObjectAdmin
Update an existing server object configuration with the UpdateConfiguration method on IServerObjectAdmin
View the administrator level properties of an existing server object configuration. Administrator level properties are those that are not available through the IServerObjectConfigurationInfo interface, and include:
Properties that are available through bot the IServerObjectConfiguration (read/write) and IServerObjectConfigurationInfo (read only) interfaces include:
Description | ||
---|---|---|
Description | Description of the server object configuration. | |
IsolationLevel | The isolation level of the server objects defined by the server object configuration. | |
IsPooled | Indicates whether the server objects defined by this configuration are pooled. | |
MaxInstances | The maximum number of server object instances for a server object configuration. | |
MinInstances | The minimum number of server object instances for a server object configuration. | |
Name | Name of the server object configuration. | |
Properties | Initialization parameters and properties for the server objects created by the server object configuration. | |
RecycleProperties | The recycling properties for the server object configuration. | |
StartupType | The startup type for this server object configuration. Startup type describes whether the server object configuration is started when the server object manager service is started for the GIS server. | |
TypeName | Type of the server object configuration (MapServer or GeocodeServer). | |
UsageTimeout | Maximum time (in seconds) a client can hold onto an instance of a server object for this server object configuration before releasing it back to the server. It is the maximum time allowed between calling CreateServerContext and ReleaseServerContext. | |
WaitTimeout | Maximum time (in seconds) a client will wait for an instance of a server object for this server object configuration using the CreateServerContext method on IServerObjectManager before timing out. |
CoClasses and Classes | Description |
---|---|
ServerObjectConfiguration | The ServerObjectConfiguration object which defines the properties and behavior for server objects running in the GIS server. |
The ArcGIS Server manages a set of server objects running across one or more host (container) machines. How those server objects are configured and run is defined by a set of server object configurations. Server object configurations can be added, removed, and modified by users or developers who are members of the agsadmin users group, and therfore have administrator priviliges on the ArcGIS Server.
The IServerObjectConfiguration interface is a read/write interface on a server object configuration that allows administrators to configure new server object configurations to add to the server, update existing server object confiurations, and to view the configuration properties of a server object configuration.
Users and developers that are not part the the agsadmin user group do not have access to this interface. An additional read-only interface called IServerObjectConfigurationInfo is available to non-administrators, which provides read-only access to a subset of the server object configuration's properties.
If you use IServerObjectConfiguration to modify any of a configuration's properties, you must call UpdateConfiguration on IServerObjectAdmin for those changes to be reflected in the server.
IServerObjectAdmin Interface | MapServer Class | IEnumServerObjectType Interface | ServerObject Class | IEnumServerObjectTypeInfo Interface | AGSLocatorWorkspace Class | ILocatorManager2.GetAGSLocatorWorkspace Method | GeocodeServer Class | AGSAddressLocator Class | ILocatorWorkspaceName2.AGSServerConnectionName Property | ServerObject Class | IEnumServerObjectTypeInfo Interface | IEnumServerObjectType Interface | IPropertySet Interface | GISServerConnection Class