IWorkspaceFactoryStatus Interface

Provides access to members that manage workspace status information.

Members

Name 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.

IWorkspaceFactoryStatus.OpenAvailableWorkspace Method

Makes an attempt to open a new instance of a workspace that is esriWCSDown but has since become esriWCSAvailable.

Public Function OpenAvailableWorkspace ( _
    ByVal wstatus As IWorkspaceStatus _
) As IWorkspace
public IWorkspace OpenAvailableWorkspace (
    IWorkspaceStatus wstatus
);

IWorkspaceFactoryStatus.PingWorkspaceStatus Method

Checks if the status of an esriWCSDown workspace has changed.

Public Function PingWorkspaceStatus ( _
    ByVal Workspace As IWorkspace _
) As IWorkspaceStatus
public IWorkspaceStatus PingWorkspaceStatus (
    IWorkspace Workspace
);

IWorkspaceFactoryStatus.WorkspaceStatus Property

Retrieve the workspace status information for all currently opened workspaces.

Public ReadOnly Property WorkspaceStatus As IEnumWorkspaceStatus
public IEnumWorkspaceStatus WorkspaceStatus {get;}

Classes that implement IWorkspaceFactoryStatus

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).

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.