ICOMAdminCatalog interface

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.

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

PropertyAccess typeDescription

MajorVersion

Read-only

Retrieves the major version number of the COMAdmin library.

MinorVersion

Read-only

Retrieves the minor version number of the COMAdmin library.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

ComAdmin.h

IDL

ComAdmin.Idl

 

 

Show: