com.esri.arcgis.geodatabase
Interface IRemoteDatabaseWorkspaceFactory

All Superinterfaces:

Serializable

All Known Implementing Classes:

AMSWorkspaceFactory, OLEDBWorkspaceFactory, SdeWorkspaceFactory, SqlWorkspaceFactory

public interface IRemoteDatabaseWorkspaceFactory
extends Serializable

Provides access to members that manage remote database connection information.

Remarks

The IRemoteDatabaseWorkspaceFactory is an optional interface supported by remote database workspaces that contains additional methods for connection file management.

Product Availability

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

See Also:

IWorkspace

Method Summary

void	deleteConnectionFile(String pathName) Deletes the remote database workspace connection file.
IWorkspaceName	editConnectionFile(String pathName, int hWnd) Edits the properties of a remote database workspace connection file.
IWorkspaceName	renameConnectionFile(String oldPathName, String newName) Renames the remote database workspace connection file.

Method Detail

deleteConnectionFile

void deleteConnectionFile(String pathName)
                          throws IOException,
                                 AutomationException

Deletes the remote database workspace connection file.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

pathName - The pathName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

renameConnectionFile

IWorkspaceName renameConnectionFile(String oldPathName,
                                    String newName)
                                    throws IOException,
                                           AutomationException

Renames the remote database workspace connection file.

Remarks

The oldPathName is the path and connection file name. the newName is the new file name without a path. An error is returned if newName has a fully qualified path.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

oldPathName - The oldPathName (in)

newName - The newName (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.IWorkspaceName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

editConnectionFile

IWorkspaceName editConnectionFile(String pathName,
                                  int hWnd)
                                  throws IOException,
                                         AutomationException

Edits the properties of a remote database workspace connection file.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

pathName - The pathName (in)

hWnd - The hWnd (A COM typedef) (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.IWorkspaceName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.