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