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

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

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

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

Заметка

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

 

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

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

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

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

Библиотека COMAdmin

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

Коллекция	Описание
ApplicationCluster	Содержит список серверов в кластере приложений.
ApplicationInstances	Содержит объект для каждого экземпляра запущенного приложения COM+.
приложения	Содержит объект для каждого приложения COM+, установленного на локальном компьютере.
компоненты	Содержит объект для каждого компонента в приложении, к которому он связан.
ComputerList	Содержит список компьютеров, найденных в папке компьютеров средства администрирования служб компонентов.
DCOMProtocols	Содержит список протоколов, используемых DCOM. Он содержит объект для каждого протокола.
ErrorInfo	Извлекает расширенные сведения об ошибках в отношении методов, которые имеют дело с несколькими объектами.
EventClassesForIID	Извлекает сведения о классах событий.
FilesForImport	Извлекает сведения из msi-файла о приложении, которое можно импортировать.
InprocServers	Содержит список внутрипроцессных серверов, зарегистрированных в системе. Он содержит объект для каждого компонента.
InterfacesForComponent	Содержит объект для каждого интерфейса, предоставляемого компонентом, к которому связана коллекция.
устаревшие	Содержит объект для каждого ненастроенного компонента в приложении, к которому он связан.
устаревших серверов	Идентичен коллекцииinprocServers, за исключением того, что эта коллекция также включает локальные серверы.
LocalComputer	Содержит один объект, содержащий сведения о параметрах уровня компьютера для компьютера, к которому вы обращаетесь.
MethodsForInterface	Содержит объект для каждого метода в интерфейсе, к которому связана коллекция.
Секции	Используется для указания приложений, содержащихся в каждой секции.
PartitionUsers	Используется для указания пользователей, содержащихся в каждой секции.
PropertyInfo	Извлекает сведения о свойствах, поддерживаемых указанной коллекцией.
PublisherProperties	Содержит объект для каждого свойства издателя для родительской коллекции SubscriptionsForComponent.
RelatedCollectionInfo	Извлекает сведения о других коллекциях, связанных с коллекцией, из которой она вызывается.
ролей	Содержит объект для каждой роли, назначенной приложению, к которому она связана.
RoleForComponent	Содержит объект для каждой роли, назначенной компоненту, к которому связана коллекция.
RoleForInterface	Содержит объект для каждой роли, назначенной интерфейсу, к которому связана коллекция.
RoleForMethod	Содержит объект для каждой роли, назначенной методу, которому связана коллекция.
RoleForPartition	Содержит объект для каждой роли, назначенной секции, к которой связана коллекция.
корневой	Содержит коллекции верхнего уровня в каталоге.
подписчика	Содержит объект для каждого свойства подписчика для родительской коллекции SubscriptionsForComponent.
SubscriptionsForComponent	Содержит объект для каждой подписки для родительской Компонентов коллекции.
TransientPublisherProperties	Содержит объект для каждого свойства издателя для родительской коллекции TransientSubscriptions.
TransientSubscriberProperties	Содержит объект для каждого свойства подписчика для родительской коллекции TransientSubscriptions.
transientSubscriptions	Содержит объект для каждой временной подписки.
UsersInPartitionRole	Содержит объект для каждого пользователя в роли секции, к которой связана коллекция.
UsersInRole	Содержит объект для каждого пользователя в роли, к которой связана коллекция.
WOWInprocServers	Содержит список внутрипроцессных серверов, зарегистрированных в системе для 32-разрядных компонентов на 64-разрядных компьютерах.
WOWLegacyServers	Идентичен коллекцииlegacyServers, за исключением того, что эта коллекция извлекается из 32-разрядного реестра на 64-разрядных компьютерах.