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.

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 en 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.