ICOMAdminCatalog interface
Applies to: desktop apps only
Initiates a session to do programmatic COM+ administration, access collections in the catalog, install COM+ applications and components, start and stop services, and connect to remote servers. ICOMAdminCatalog provides access to the COM+ catalog data store.
When to implement
You do not need to implement the ICOMAdminCatalog interface.
When to use
Use ICOMAdminCatalog to initiate navigation of the COM+ catalog collections and to perform automated administration of COM+ applications and services. Use the Connect method to connect to the catalog on other computers to do remote administration. Use the GetCollection method to retrieve top-level collections in the currently active catalog. These collections can be represented and navigated using ICatalogCollection. The items within a given collection can be represented and examined or modified using ICatalogObject.
In COM+ 1.5, released with Windows XP, the ICOMAdminCatalog interface is superseded by the ICOMAdminCatalog2 interface. In addition to providing new functionality, the ICOMAdminCatalog2 interface provides access to the methods of ICOMAdminCatalog.
For information regarding the collections in the COM+ catalog, see COM+ Administration Collections.
For an introduction to programmatic administration of COM+, see Automating COM+ Administration.
Members
The ICOMAdminCatalog interface inherits from the IDispatch interface. ICOMAdminCatalog also has these types of members:
Methods
The ICOMAdminCatalog interface has these methods.
| Method | Description |
|---|---|
| BackupREGDB |
Backs up the COM+ class registration database to a specified file. |
| Connect |
Connects to the COM+ catalog on a specified remote computer. |
| ExportApplication |
Exports a COM+ application or application proxy to a file, ready for installation on different computers. |
| GetCollection |
Retrieves a top-level collection on the COM+ catalog. |
| GetCollectionByQuery |
Retrieves a collection on the COM+ catalog given the key property values for all of its parent items. |
| GetEventClassesForIID |
Retrieves a list of the event classes registered on the computer that implement a specified interface. |
| GetMultipleComponentsInfo |
Retrieves information about the components found in the specified files. |
| ImportComponent |
Imports a component already registered as an in-process server into a COM+ application. |
| InstallApplication |
Installs a COM+ application or application proxy from the specified file. |
| InstallComponent |
Installs all components (COM classes) from a DLL file into a COM+ application and registers the components in the COM+ class registration database. |
| InstallEventClass |
Installs event classes from a file into a COM+ application. |
| InstallMultipleComponents |
Installs components from multiple files into a COM+ application. |
| InstallMultipleEventClasses |
Installs event classes from multiple files into a COM+ application. |
| QueryApplicationFile |
Retrieves information about a COM+ application from an application file. |
| RefreshComponents |
Updates component registration information from the registry. |
| RefreshRouter |
Obsolete. |
| Reserved1 |
Reserved for future use. |
| Reserved2 |
Reserved for future use. |
| RestoreREGDB |
Restores the COM+ class registration database (RegDB) from the specified file. |
| ServiceCheck |
Retrieves the current status of the specified COM+ service. |
| ShutdownApplication |
Initiates shutdown of a COM+ server application process. |
| StartApplication |
Starts the specified COM+ server application. |
| StartRouter |
Starts the component load balancing service if the service is currently installed. |
| StopRouter |
Stops the component load balancing service if the service is currently installed. |
Properties
The ICOMAdminCatalog interface has these properties.
| Property | Access type | Description |
|---|---|---|
| Read-only |
Retrieves the major version number of the COMAdmin library. | |
| Read-only |
Retrieves the minor version number of the COMAdmin library. |
Requirements
|
Minimum supported client | Windows 2000 Professional |
|---|---|
|
Minimum supported server | Windows 2000 Server |
|
Header |
|
|
IDL |
|
Send comments about this topic to Microsoft
Build date: 2/3/2012
