COM+ Administration Collections

The COM+ administration collections serve to hold and organize configuration data stored in the COM+ catalog. The collections correspond to folders in the console tree of the Component Services administration tool. You can access these collections by using the COM+ administration objects and interfaces.

You initiate programmatic administration by using objects created from the COMAdminCatalog class, you represent any collections in the catalog by using objects created from the COMAdminCatalogCollection class, and you represent items in collections by using objects created from the COMAdminCatalogObject class.

The items in a given collection expose a consistent set of properties. For example, every item in the Components collection represents a component, and the items in the Components collection expose the same properties used to configure a component. These properties can be accessed by using the COMAdminCatalogObject class.

Note

Properties with WriteOnce access are ReadWrite while using the Add method prior to using SaveChanges and are ReadOnly afterward.

 

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

Collection Hierarchy

The following figure illustrates the relationships among the collections. The collections at the far left (in white and gray boxes) are top-level collections, which are accessed by calling the GetCollection method of an object created from the COMAdminCatalog class. The remaining collections (in yellow boxes) can only be accessed through their parent collection, by calling the GetCollection method of the COMAdminCatalogCollection object that represents their parent. The arrows point from a parent collection to its child collections.

The following four collections are not illustrated in the figure: ErrorInfo, PropertyInfo, RelatedCollectionInfo, and Root. The ErrorInfo collection is a child of every collection in the figure except InprocServers and WOWInprocServers (in gray boxes). The PropertyInfo and RelatedCollectionInfo collections are children of every collection. The Root collection is a top-level collection that is the parent of all other top-level collections. However, it is not necessary to access the Root collection before accessing other top-level collections.

COMAdmin Library

The following collections are supported by the COMAdmin library.

Collection Description
ApplicationCluster Contains a list of the servers in the application cluster.
ApplicationInstances Contains an object for each instance of a running COM+ application.
Applications Contains an object for each COM+ application installed on the local computer.
Components Contains an object for each component in the application to which it is related.
ComputerList Contains a list of the computers found in the Computers folder of the Component Services administration tool.
DCOMProtocols Contains a list of the protocols to be used by DCOM. It contains an object for each protocol.
ErrorInfo Retrieves extended error information regarding methods that deal with multiple objects.
EventClassesForIID Retrieves information regarding event classes.
FilesForImport Retrieves information from its MSI file about an application that can be imported.
InprocServers Contains a list of the in-process servers registered with the system. It contains an object for each component.
InterfacesForComponent Contains an object for each interface exposed by the component to which the collection is related.
LegacyComponents Contains an object for each unconfigured component in the application to which it is related.
LegacyServers Identical to the InprocServers collection except that this collection also includes local servers.
LocalComputer Contains a single object that holds computer level settings information for the computer whose catalog you are accessing.
MethodsForInterface Contains an object for each method on the interface to which the collection is related.
Partitions Used to specify the applications contained in each partition.
PartitionUsers Used to specify the users contained in each partition.
PropertyInfo Retrieves information about the properties that a specified collection supports.
PublisherProperties Contains an object for each publisher property for the parent SubscriptionsForComponent collection.
RelatedCollectionInfo Retrieves information about other collections related to the collection from which it is called.
Roles Contains an object for each role assigned to the application to which it is related.
RolesForComponent Contains an object for each role assigned to the component to which the collection is related.
RolesForInterface Contains an object for each role assigned to the interface to which the collection is related.
RolesForMethod Contains an object for each role assigned to the method to which the collection is related.
RolesForPartition Contains an object for each role assigned to the partition to which the collection is related.
Root Contains the top-level collections on the catalog.
SubscriberProperties Contains an object for each subscriber property for the parent SubscriptionsForComponent collection.
SubscriptionsForComponent Contains an object for each subscription for the parent Components collection.
TransientPublisherProperties Contains an object for each publisher property for the parent TransientSubscriptions collection.
TransientSubscriberProperties Contains an object for each subscriber property for the parent TransientSubscriptions collection.
TransientSubscriptions Contains an object for each transient subscription.
UsersInPartitionRole Contains an object for each user in the partition role to which the collection is related.
UsersInRole Contains an object for each user in the role to which the collection is related.
WOWInprocServers Contains a list of the in-process servers registered with the system for 32-bit components on 64-bit computers.
WOWLegacyServers Identical to the LegacyServers collection except that this collection is drawn from the 32-bit registry on 64-bit computers.