This document is archived and information here might be outdated.  Recommended version.


IWorkspaceFactoryStatus Interface (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (GeoDatabase)  

IWorkspaceFactoryStatus Interface

Provides access to members that manage workspace status information.

Product Availability

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

Members

Description
Method OpenAvailableWorkspace Makes an attempt to open a new instance of a workspace that is esriWCSDown but has since become esriWCSAvailable.
Method PingWorkspaceStatus Checks if the status of an esriWCSDown workspace has changed.
Read-only property WorkspaceStatus Retrieve the workspace status information for all currently opened workspaces.

CoClasses that implement IWorkspaceFactoryStatus

CoClasses and Classes Description
SdeWorkspaceFactory (esriDataSourcesGDB) Esri SDE Workspace Factory.

Remarks

The IWorkspaceFactoryStatus interface is supported on SdeWorkspaceFactory objects and provides the capability to report on the status of a particular workspace. The ability to reconnect to a interrupted connect is also provided through this interface. This interface is useful in applications that need to check for interruptions in workspace connections. Such interruptions may be due to the SDE server being shutdown, or a network interruption between the client and the SDE server.

The WorkspaceStatus property returns an enumeration of IWorkspaceStatus objects for all currently open workspaces. This property should be used as a course grained object to determine the current status of the workspace connection (esriWCSUp or esriWCSDown). Use IWorkspaceStatus::ConnectionStatus property to determine the status of a particular workspace. The values of esriWorkspaceConnectionStatus returned by the WorkspaceStatus property are:

·                 esriWCSUp indicates that the workspace is up.

·                 esriWCSDown indicates that the workspace has lost its connection.

If the status of a workspace connection is esriWCSDown a reconnection can be made to the workspace once the workspace becomes available for reconnection. It is recommended to use the PingWorkspaceStatus method to obtain the current status of the down workspace. If the connection status has changed from esriWCSDown to esriWCSAvailable the OpenAvailableWorkspace method can be used to get a reference to the workspace.

Note that OpenAvailableWorkspace does not repair the original workspace, but provides a mechanism to get a new one when reconnection is possible. It is the responsibility of the application to refresh other objects that rely on the new workspace (for example, opening a feature class from the new workspace and setting it into a feature layer).