COMAdminCatalog class

Accesses the data that is stored in the COM+ catalog.

When to implement

This class is implemented by COM+.

Requirement Value
CLSID CLSID_COMAdminCatalog
ProgID L"COMAdmin.COMAdminCatalog"
Interfaces ICOMAdminCatalog
ICOMAdminCatalog2

When to use

You use objects created from the COMAdminCatalog class to begin programmatic access to COM+ configuration data stored in the COM+ catalog. This information underlies the folders and items in the console tree of the Component Services administration tool. The COMAdminCatalog class enables you to access collections in the catalog, install COM+ applications and components, start and stop services, and connect to and administer remote servers.

Folders in the Component Services administration tool correspond to collections in the catalog, which you can represent by using objects created from the COMAdminCatalogCollection class. Items in the folders correspond to items in the collections, which you can represent by using objects created from the COMAdminCatalogObject class.

Not all of the collections and items exposed through COMAdminCatalogCollection and COMAdminCatalogObject are available in the Component Services administration tool.

For information regarding specific collections and their properties, see COM+ Administration Collections.

For an introduction to programmatic administration of COM+, see Automating COM+ Administration.

Remarks

To create this object, call CoCreateInstance.

To use this class from Microsoft Visual Basic, add a reference to the COM+ Admin Type Library. A COMAdminCatalog object can be declared using "COMAdmin.COMAdminCatalog" as the class name.

In COM+ 1.5, released with Windows XP, the COMAdminCatalog class implements the ICOMAdminCatalog2 interface. However, in COM+ 1.0, released with Windows 2000, the COMAdminCatalog class implements only the ICOMAdminCatalog interface.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
ComAdmin.h
IDL
ComAdmin.Idl

See also

COMAdminCatalogCollection

COMAdminCatalogObject

ICOMAdminCatalog

ICOMAdminCatalog2