com.esri.arcgis.server
Interface IServerObjectAdmin4

All Superinterfaces:

IServerObjectAdmin, IServerObjectAdmin2, IServerObjectAdmin3, Serializable

All Known Subinterfaces:

IServerObjectAdmin5, IServerObjectAdmin6, IServerObjectAdmin7

All Known Implementing Classes:

IServerObjectAdmin4Proxy, IServerObjectAdmin5Proxy, IServerObjectAdmin6Proxy, ServerObjectAdmin

public interface IServerObjectAdmin4
extends IServerObjectAdmin3, Serializable

Provides access to members that administer the ArcGIS server.

Description

IServerObjectAdmin4 provides methods to retrieve server configuration information and to administer the ArcGIS Server.

The IServerObjectAdmin4 interface can be obtained by a query interface with the IServerObjectAdmin interface.

Product Availability

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

Method Summary

boolean	isSecurityEnabled() Indicates whether security is switched on or off.
void	setIsSecurityEnabled(boolean pVal) Indicates whether security is switched on or off.

Methods inherited from interface com.esri.arcgis.server.IServerObjectAdmin3

getConfigurationsEx2

Methods inherited from interface com.esri.arcgis.server.IServerObjectAdmin2

addExtensionType, createExtensionType, createFolder, deleteExtensionType, deleteFolder, disable, enable, getConfigurationsEx, getExtensionTypes, getFolderInfo, getFolders, getServerLog, renameFolder, setFolderInfo, validateConfiguration

Methods inherited from interface com.esri.arcgis.server.IServerObjectAdmin

addConfiguration, addMachine, addServerDirectory, createConfiguration, createMachine, createServerDirectory, deleteConfiguration, deleteMachine, deleteServerDirectory, getConfiguration, getConfigurations, getConfigurationStatus, getMachine, getMachines, getProperties, getServerDirectories, getServerDirectory, getTypes, pauseConfiguration, setProperties, startConfiguration, stopConfiguration, updateConfiguration, updateMachine, updateServerDirectory

Method Detail

isSecurityEnabled

boolean isSecurityEnabled()
                          throws IOException,
                                 AutomationException

Indicates whether security is switched on or off.

Remarks

IsSecurityEnabled has a Default value of OFF.

This switch does NOT affect

- any methods called on IServerObjectAdmin, IServerObjectAdmin2 or IServerObjectAdmin3

- any methods called on IServerObjectManager, IServerObjectManager2, IServerObjectManager3 or IServerObjectManager4 obtained from IGISServerConnection.ServerObjectManager..

This swtich DOES affect the following IServerObjectManager methods only when the interfaces are accessed through IGISServerConnection2.ServerObjectManager:

 IServerObjectManager.CreateServerContext

 IServerObjectManager.GetConfigurationInfo

 IServerObjectManager.GetConfigurationInfos



 IServerObjectManager2.GetConfigurationInfosEx

 IServerObjectManager2.GetFolders

 IServerObjectManager2.FolderInfo

 IServerObjectManager2.GetConfigurationStatus



 IServerObjectManager3.GetConfigurationInfosEx2

In the case that a user does not have permissions to access a particular resource (e.g configuration or folder ), each of the methods above will return ACCESSDENIED errors and produce the following error message:

"User X does not have sufficient permissions to access Y."

When a user obtains a list of configurations, configurationInfos or Folders it will NOT contain resources to which the user does not have access.

VERY IMPORTANT - If you disable security through the API with a call to IPermissionsAdmin.IsSecurityEnabled = false, you will have exposed all of your web services to the public internet and security will be defeated. Disable security at your own risk!

Product Availability

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

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setIsSecurityEnabled

void setIsSecurityEnabled(boolean pVal)
                          throws IOException,
                                 AutomationException

Indicates whether security is switched on or off.

Product Availability

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

Parameters:

pVal - The pVal (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.