Коллекции администрирования COM+

Коллекции администрирования COM+ служат для хранения и упорядочения данных конфигурации, хранящихся в каталоге COM+. Коллекции соответствуют папкам в дереве консоли средства администрирования служб компонентов. Доступ к этим коллекциям можно получить с помощью объектов и интерфейсов администрирования COM+.

Вы инициируете программное администрирование с помощью объектов, созданных из класса COMAdminCatalog , вы представляете все коллекции в каталоге с помощью объектов, созданных из класса COMAdminCatalogCollection , и вы представляете элементы в коллекциях с помощью объектов, созданных из класса COMAdminCatalogObject .

Элементы в данной коллекции предоставляют согласованный набор свойств. Например, каждый элемент в коллекции "Компоненты " представляет компонент, а элементы в коллекции "Компоненты " предоставляют те же свойства, что и для настройки компонента. Доступ к этим свойствам можно получить с помощью класса COMAdminCatalogObject .

Примечание

Свойства с доступом WriteOnce являются ReadWrite при использовании метода Add до использования SaveChanges и являются readOnly после этого.

 

Общие сведения о программном администрировании COM+см. в разделе "Автоматизация администрирования COM+".

Иерархия коллекций

На следующем рисунке показаны связи между коллекциями. Коллекции в крайнем левом углу (в белых и серых полях) — это коллекции верхнего уровня, к которым обращается метод GetCollection объекта, созданного из класса COMAdminCatalog . Доступ к остальным коллекциям (в желтых полях) можно получить только через родительскую коллекцию, вызвав метод GetCollection объекта COMAdminCatalogCollection , представляющего их родительский объект. Стрелки указывают от родительской коллекции к дочерним коллекциям.

Diagram that shows the relationships among the collections.

На рисунке не показаны следующие четыре коллекции: ErrorInfo, PropertyInfo, RelatedCollectionInfo и Root. Коллекция ErrorInfo является дочерним элементом каждой коллекции на рисунке, за исключением InprocServers и WOWInprocServers (в серых полях). Коллекции PropertyInfo и RelatedCollectionInfo являются дочерними элементами каждой коллекции. Корневая коллекция — это коллекция верхнего уровня, которая является родительским для всех других коллекций верхнего уровня. Однако перед доступом к другим коллекциям верхнего уровня доступ к корневой коллекции не требуется.

Библиотека COMAdmin

Следующие коллекции поддерживаются библиотекой COMAdmin.

Коллекция Описание
ApplicationCluster Содержит список серверов в кластере приложений.
ApplicationInstances Содержит объект для каждого экземпляра запущенного приложения COM+.
Приложения Содержит объект для каждого приложения COM+, установленного на локальном компьютере.
Компоненты Содержит объект для каждого компонента в приложении, к которому он связан.
ComputerList Содержит список компьютеров, найденных в папке "Компьютеры " средства администрирования служб компонентов.
DCOMProtocols Содержит список протоколов, используемых DCOM. Он содержит объект для каждого протокола.
ErrorInfo Извлекает расширенные сведения об ошибках, касающиеся методов, которые имеют дело с несколькими объектами.
EventClassesForIID Извлекает сведения о классах событий.
FilesForImport Извлекает сведения из MSI-файла о приложении, которое можно импортировать.
InprocServers Содержит список внутрипроцессных серверов, зарегистрированных в системе. Он содержит объект для каждого компонента.
InterfacesForComponent Содержит объект для каждого интерфейса, предоставляемого компонентом, с которым связана коллекция.
LegacyComponents Содержит объект для каждого ненастроенного компонента в приложении, к которому он связан.
LegacyServers Идентичен коллекции InprocServers , за исключением того, что эта коллекция также включает локальные серверы.
LocalComputer Содержит один объект, содержащий сведения о параметрах уровня компьютера для компьютера, к каталогу которого вы обращаетесь.
MethodsForInterface Содержит объект для каждого метода в интерфейсе, с которым связана коллекция.
Секции Используется для указания приложений, содержащихся в каждой секции.
PartitionUsers Используется для указания пользователей, содержащихся в каждой секции.
Propertyinfo Извлекает сведения о свойствах, поддерживаемых указанной коллекцией.
PublisherProperties Содержит объект для каждого свойства издателя для родительской коллекции SubscriptionsForComponent .
RelatedCollectionInfo Извлекает сведения о других коллекциях, связанных с коллекцией, из которой она вызывается.
Роли Содержит объект для каждой роли, назначенной приложению, к которому она связана.
RolesForComponent Содержит объект для каждой роли, назначенной компоненту, с которым связана коллекция.
RolesForInterface Содержит объект для каждой роли, назначенной интерфейсу, с которым связана коллекция.
RolesForMethod Содержит объект для каждой роли, назначенной методу, с которым связана коллекция.
RolesForPartition Содержит объект для каждой роли, назначенной секции, с которой связана коллекция.
Root Содержит коллекции верхнего уровня в каталоге.
SubscriberProperties Содержит объект для каждого свойства подписчика для родительской коллекции SubscriptionsForComponent .
SubscriptionsForComponent Содержит объект для каждой подписки для родительской коллекции компонентов .
TransientPublisherProperties Содержит объект для каждого свойства издателя для родительской коллекции TransientSubscriptions .
TransientSubscriberProperties Содержит объект для каждого свойства подписчика для родительской коллекции TransientSubscriptions .
TransientSubscriptions Содержит объект для каждой временной подписки.
UsersInPartitionRole Содержит объект для каждого пользователя в роли секции, с которой связана коллекция.
UsersInRole Содержит объект для каждого пользователя в роли, с которой связана коллекция.
WOWInprocServers Содержит список внутрипроцессных серверов, зарегистрированных в системе для 32-разрядных компонентов на 64-разрядных компьютерах.
WOWLegacyServers Идентичен коллекции LegacyServers , за исключением того, что эта коллекция извлекается из 32-разрядного реестра на 64-разрядных компьютерах.