PlugInWorkspaceFactory CoClass

ESRI Plug-In Workspace Factory.

Product Availability

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

Description

The PlugInWorkspaceFactory is a workspace factory for read-only data sources.

Supported Platforms

Windows, Solaris, Linux

Interfaces

Interfaces	Description
IWorkspaceFactory	Provides access to members that create and open workspaces and supply workspace factory information.
IWorkspaceFactory2	Provides access to members that create and open workspaces and supply workspace factory information.

Remarks

When you implement a plug-in data source using C++ or any other COM-compliant language that supports aggregation, your PlugInWorkspaceFactoryHelper coclass must aggregate the PlugInWorkspaceFactory coclass.

When you implement a plug-in data source using a language that does not support aggregation, such as Visual Basic, your PlugInWorkspaceFactoryHelper coclass does not aggregate the PlugInWorkspaceFactory coclass. Instead, the PlugInWorkspaceFactory coclass will aggregate your PlugInWorkspaceFactoryHelper coclass. If you use Visual Basic to implement your plug-in data source, use the following procedure to register your PlugInWorkspaceFactoryHelper:

Implement the IPlugInWorkspaceFactoryHelper interface in your PlugInWorkspaceFactoryHelper coclass. The IPlugInWorkspaceFactoryHelper::WorkspaceFactoryTypeID property must return a GUID that is not the GUID of your PlugInWorkspaceFactoryHelper coclass. Instead, it should be an "alias" GUID that does not refer to any coclass. You can use the GUID Generator utility in Microsoft Visual Studio to generate this GUID for you. The GUID Generator utility (GUIDGEN.EXE) is located in the Common\Tools folder in your Microsoft Visual Studio folder (usually in C:\Program Files\).
Use the Component Category Manager to register your PlugInWorkspaceFactoryHelper coclass in the ESRI Plugin Workspace Factory Helpers category.
Re-register the PlugInWorkspaceFactory.dll found in your ArcGIS bin directory. This will register your "alias" GUID in the ESRI Workspace Factories and ESRI Gx Enabled Workspace Factories categories.

By following this procedure, the PlugInWorkspaceFactory coclass will aggregate an instance of your PlugInWorkspaceFactoryHelper when ArcGIS creates a WorkspaceFactory for your plug-in data source.

Send feedback on this page