Colecciones de administración de COM+

Las colecciones de administración de COM+ sirven para contener 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 de COM+.

La administración mediante programación se inicia mediante el uso de objetos creados a partir de la clase COMAdminCatalog , se representan todas 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 clase COMAdminCatalogObject .

Los elementos de una colección determinada exponen un conjunto coherente de propiedades. Por ejemplo, cada elemento de la colección Components representa un componente y los elementos de la colección Components exponen las mismas propiedades usadas para configurar un componente. Se puede tener acceso a estas propiedades mediante la clase COMAdminCatalogObject .

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 blanco y gris) son colecciones de nivel superior, a las que se accede mediante una llamada al método GetCollection de un objeto creado a partir de la clase COMAdminCatalog . Solo se puede tener acceso a las colecciones restantes (en cuadros amarillos) a través de su colección primaria llamando al método GetCollection del objeto COMAdminCatalogCollection que representa a su elemento primario. Las flechas apuntan de una colección primaria a sus colecciones secundarias.

Diagram that shows the relationships among the collections.

Las cuatro colecciones siguientes no se muestran en la ilustración: ErrorInfo, PropertyInfo, RelatedCollectionInfo y 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 Raíz 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 Raíz antes de acceder a otras colecciones de nivel superior.

Biblioteca COMAdmin

Las colecciones siguientes son compatibles con la biblioteca COMAdmin.

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.
APLICACIONES Contiene un objeto para cada aplicación COM+ instalada en el equipo local.
Componentes 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 de la aplicación a la que está relacionado.
LegacyServers Idéntico a la colección InprocServers , salvo 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.
MethodsForInterface Contiene un objeto para cada método de la interfaz a la que está relacionada la colección.
Particiones 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 de publicador de la colección SubscriptionsForComponent primaria.
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á relacionada.
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.
RolesForMethod 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.
Root Contiene las colecciones de nivel superior en el catálogo.
SubscriberProperties Contiene un objeto para cada propiedad de suscriptor para la colección SubscriptionsForComponent primaria.
SubscriptionsForComponent Contiene un objeto para cada suscripción de la colección Components primaria.
TransientPublisherProperties Contiene un objeto para cada propiedad de publicador de la colección TransientSubscriptions primaria.
TransientSubscriberProperties Contiene un objeto para cada propiedad de suscriptor de la colección TransientSubscriptions primaria.
TransientSubscriptions 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 , salvo que esta colección se extrae del registro de 32 bits en equipos de 64 bits.