Коллекции администрирования COM+
Коллекции администрирования COM+ служат для хранения и упорядочения данных конфигурации, хранящихся в каталоге COM+. Коллекции соответствуют папкам в дереве консоли средства администрирования служб компонентов. Доступ к этим коллекциям можно получить с помощью объектов и интерфейсов администрирования COM+.
Вы инициируете программное администрирование с помощью объектов, созданных из класса COMAdminCatalog , вы представляете все коллекции в каталоге с помощью объектов, созданных из класса COMAdminCatalogCollection , и вы представляете элементы в коллекциях с помощью объектов, созданных из класса COMAdminCatalogObject .
Элементы в данной коллекции предоставляют согласованный набор свойств. Например, каждый элемент в коллекции "Компоненты " представляет компонент, а элементы в коллекции "Компоненты " предоставляют те же свойства, что и для настройки компонента. Доступ к этим свойствам можно получить с помощью класса COMAdminCatalogObject .
Примечание
Свойства с доступом WriteOnce являются ReadWrite при использовании метода Add до использования SaveChanges и являются readOnly после этого.
Общие сведения о программном администрировании COM+см. в разделе "Автоматизация администрирования COM+".
Иерархия коллекций
На следующем рисунке показаны связи между коллекциями. Коллекции в крайнем левом углу (в белых и серых полях) — это коллекции верхнего уровня, к которым обращается метод GetCollection объекта, созданного из класса COMAdminCatalog . Доступ к остальным коллекциям (в желтых полях) можно получить только через родительскую коллекцию, вызвав метод GetCollection объекта COMAdminCatalogCollection , представляющего их родительский объект. Стрелки указывают от родительской коллекции к дочерним коллекциям.
На рисунке не показаны следующие четыре коллекции: 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-разрядных компьютерах. |