Compartir a través de


Colecciones de administración de COM+

Las colecciones de administración de COM+ sirven para almacenar y organizar los datos de configuración almacenados en el catálogo COM+. Las colecciones corresponden a carpetas del árbol de consola de la herramienta de administración servicios de componentes. Puede acceder a estas colecciones mediante las interfaces y los objetos de administración com+.

La administración mediante programación se inicia mediante objetos creados a partir de la claseCOMAdminCatalog de, representa las colecciones del catálogo mediante objetos creados a partir de la clase COMAdminCatalogCollection y se representan elementos en colecciones mediante objetos creados a partir de la claseCOMAdminCatalogObject.

Los elementos de una colección determinada exponen un conjunto coherente de propiedades. Por ejemplo, cada elemento de la colección componentes de representa un componente y los elementos de la colección Components exponen las mismas propiedades que se usan para configurar un componente. Se puede acceder a estas propiedades mediante la claseCOMAdminCatalogObject.

Nota

Las propiedades con acceso WriteOnce son ReadWrite mientras se usa el método Add antes de usar SaveChanges y son ReadOnly posteriores.

 

Para obtener una introducción a la administración mediante programación de COM+, consulte Automatización de la administración de COM+.

Jerarquía de colecciones

En la ilustración siguiente se muestran las relaciones entre las colecciones. Las colecciones situadas en el extremo izquierdo (en cuadros blancos y grises) son colecciones de nivel superior, a las que se accede llamando al método GetCollection de un objeto creado a partir de la claseCOMAdminCatalog de. Solo se puede tener acceso a las colecciones restantes (en cuadros amarillos) a través de su colección primaria llamando al métodogetCollectiondel objeto COMAdminCatalogCollection que representa a su elemento primario. Las flechas apuntan de una colección primaria a sus colecciones secundarias.

Diagrama que muestra las relaciones entre las colecciones.

Las cuatro colecciones siguientes no se muestran en la ilustración: ErrorInfo, PropertyInfo, RelatedCollectionInfoy Root. La colección ErrorInfo es un elemento secundario de cada colección de la figura, excepto inprocServers y WOWInprocServers (en cuadros grises). Las colecciones PropertyInfo y RelatedCollectionInfo son elementos secundarios de cada colección. La colección Root es una colección de nivel superior que es el elemento primario de todas las demás colecciones de nivel superior. Sin embargo, no es necesario acceder a la colección de Root antes de acceder a otras colecciones de nivel superior.

Biblioteca COMAdmin

La biblioteca COMAdmin admite las siguientes colecciones.

Colección Descripción
ApplicationCluster Contiene una lista de los servidores del clúster de aplicaciones.
applicationInstances Contiene un objeto para cada instancia de una aplicación COM+ en ejecución.
Applications Contiene un objeto para cada aplicación COM+ instalada en el equipo local.
componentes de Contiene un objeto para cada componente de la aplicación a la que está relacionado.
ComputerList Contiene una lista de los equipos que se encuentran en la carpeta equipos de la herramienta de administración servicios de componentes.
DCOMProtocols Contiene una lista de los protocolos que va a usar DCOM. Contiene un objeto para cada protocolo.
errorInfo Recupera información de error extendida con respecto a los métodos que tratan con varios objetos.
EventClassesForIID Recupera información sobre las clases de eventos.
FilesForImport Recupera información de su archivo MSI sobre una aplicación que se puede importar.
inprocServers Contiene una lista de los servidores en proceso registrados en el sistema. Contiene un objeto para cada componente.
InterfacesForComponent Contiene un objeto para cada interfaz expuesta por el componente al que está relacionada la colección.
LegacyComponents Contiene un objeto para cada componente no configurado en la aplicación a la que está relacionado.
LegacyServers Idéntico al colección InprocServers, excepto que esta colección también incluye servidores locales.
LocalComputer Contiene un único objeto que contiene información de configuración de nivel de equipo para el equipo cuyo catálogo está accediendo.
métodos de ForInterface Contiene un objeto para cada método de la interfaz a la que está relacionada la colección.
particiones de Se usa para especificar las aplicaciones contenidas en cada partición.
PartitionUsers Se usa para especificar los usuarios contenidos en cada partición.
PropertyInfo Recupera información sobre las propiedades que admite una colección especificada.
PublisherProperties Contiene un objeto para cada propiedad del publicador de la colección principal SubscriptionsForComponent.
RelatedCollectionInfo Recupera información sobre otras colecciones relacionadas con la colección desde la que se llama.
roles Contiene un objeto para cada rol asignado a la aplicación a la que está relacionado.
RolesForComponent Contiene un objeto para cada rol asignado al componente al que está relacionada la colección.
RolesForInterface Contiene un objeto para cada rol asignado a la interfaz a la que está relacionada la colección.
roles de ForMethod Contiene un objeto para cada rol asignado al método al que está relacionada la colección.
RolesForPartition Contiene un objeto para cada rol asignado a la partición a la que está relacionada la colección.
raíz Contiene las colecciones de nivel superior del catálogo.
SubscriberProperties Contiene un objeto para cada propiedad de suscriptor de la colección principal SubscriptionsForComponent.
SubscriptionsForComponent Contiene un objeto para cada suscripción para la colección principal Components.
transientPublisherProperties Contiene un objeto para cada propiedad del publicador de la colección principal TransientSubscriptions.
transientSubscriberProperties Contiene un objeto para cada propiedad de suscriptor del colección TransientSubscriptions principal.
detransientSubscriptions Contiene un objeto para cada suscripción transitoria.
UsersInPartitionRole Contiene un objeto para cada usuario del rol de partición al que está relacionada la colección.
UsersInRole Contiene un objeto para cada usuario del rol al que está relacionada la colección.
WOWInprocServers Contiene una lista de los servidores en proceso registrados con el sistema para componentes de 32 bits en equipos de 64 bits.
WOWLegacyServers Idéntico a la colección LegacyServers, excepto que esta colección se dibuja del registro de 32 bits en equipos de 64 bits.