Regroupements d’administration COM+
Les collections d’administration COM+ servent à stocker et à organiser les données de configuration stockées dans le catalogue COM+. Les collections correspondent aux dossiers de l’arborescence de console de l’outil d’administration Component Services. Vous pouvez accéder à ces collections à l’aide des objets et interfaces d’administration COM+.
Vous lancez l’administration par programmation à l’aide d’objets créés à partir de la classe COMAdminCatalog , vous représentez toutes les collections du catalogue à l’aide d’objets créés à partir de la classe COMAdminCatalogCollection , et vous représentez les éléments des collections à l’aide d’objets créés à partir de la classe COMAdminCatalogObject .
Les éléments d’une collection donnée exposent un ensemble cohérent de propriétés. Par exemple, chaque élément de la collection Components représente un composant, et les éléments de la collection Components exposent les mêmes propriétés que celles utilisées pour configurer un composant. Ces propriétés sont accessibles à l’aide de la classe COMAdminCatalogObject .
Notes
Les propriétés avec accès WriteOnce sont ReadWrite lors de l’utilisation de la méthode Add avant d’utiliser SaveChanges et sont ReadOnly par la suite.
Pour une présentation de l’administration programmatique de COM+, consultez Automatisation de l’administration COM+.
Hiérarchie de collection
La figure suivante illustre les relations entre les collections. Les collections situées à l’extrême gauche (dans les zones blanches et grises) sont des collections de niveau supérieur accessibles en appelant la méthode GetCollection d’un objet créé à partir de la classe COMAdminCatalog . Les collections restantes (dans des zones jaunes) sont accessibles uniquement par le biais de leur collection parente, en appelant la méthode GetCollection de l’objet COMAdminCatalogCollection qui représente leur parent. Les flèches pointent d’une collection parente vers ses collections enfants.
Les quatre collections suivantes ne sont pas illustrées dans la figure : ErrorInfo, PropertyInfo, RelatedCollectionInfo et Root. La collection ErrorInfo est un enfant de chaque collection de la figure, à l’exception de InprocServers et WOWInprocServers (dans les zones grises). Les collections PropertyInfo et RelatedCollectionInfo sont des enfants de chaque collection. La collection Root est une collection de niveau supérieur qui est le parent de toutes les autres collections de niveau supérieur. Toutefois, il n’est pas nécessaire d’accéder à la collection Racine avant d’accéder à d’autres collections de niveau supérieur.
Bibliothèque COMAdmin
Les collections suivantes sont prises en charge par la bibliothèque COMAdmin.
| Collection | Description |
|---|---|
| ApplicationCluster | Contient une liste des serveurs dans le cluster d’applications. |
| ApplicationInstances | Contient un objet pour chaque instance d’une application COM+ en cours d’exécution. |
| Applications | Contient un objet pour chaque application COM+ installée sur l’ordinateur local. |
| Composants | Contient un objet pour chaque composant de l’application à laquelle il est lié. |
| ComputerList | Contient la liste des ordinateurs trouvés dans le dossier Ordinateurs de l’outil d’administration Services de composants. |
| DCOMProtocols | Contient une liste des protocoles à utiliser par DCOM. Il contient un objet pour chaque protocole. |
| ErrorInfo | Récupère des informations d’erreur étendues concernant les méthodes qui traitent plusieurs objets. |
| EventClassesForIID | Récupère des informations concernant les classes d’événements. |
| FilesForImport | Récupère des informations à partir de son fichier MSI sur une application qui peut être importée. |
| InprocServers | Contient une liste des serveurs in-process inscrits auprès du système. Il contient un objet pour chaque composant. |
| InterfacesForComponent | Contient un objet pour chaque interface exposée par le composant auquel la collection est liée. |
| LegacyComponents | Contient un objet pour chaque composant non configuré dans l’application à laquelle il est lié. |
| LegacyServers | Identique à la collection InprocServers , sauf que cette collection inclut également des serveurs locaux. |
| LocalComputer | Contient un objet unique qui contient les informations de paramètres au niveau de l’ordinateur pour l’ordinateur auquel vous accédez au catalogue. |
| MethodsForInterface | Contient un objet pour chaque méthode sur l’interface à laquelle la collection est liée. |
| Partitions | Permet de spécifier les applications contenues dans chaque partition. |
| PartitionUsers | Permet de spécifier les utilisateurs contenus dans chaque partition. |
| Propertyinfo | Récupère des informations sur les propriétés prises en charge par une collection spécifiée. |
| PublisherProperties | Contient un objet pour chaque propriété d’éditeur pour la collection Parent SubscriptionsForComponent . |
| RelatedCollectionInfo | Récupère des informations sur d’autres collections liées à la collection à partir de laquelle elle est appelée. |
| Rôles | Contient un objet pour chaque rôle attribué à l’application à laquelle il est lié. |
| RolesForComponent | Contient un objet pour chaque rôle attribué au composant auquel la collection est liée. |
| RolesForInterface | Contient un objet pour chaque rôle attribué à l’interface à laquelle la collection est liée. |
| RolesForMethod | Contient un objet pour chaque rôle attribué à la méthode à laquelle la collection est liée. |
| RolesForPartition | Contient un objet pour chaque rôle attribué à la partition à laquelle la collection est liée. |
| Root | Contient les collections de niveau supérieur sur le catalogue. |
| SubscriberProperties | Contient un objet pour chaque propriété d’abonné pour la collection Parent SubscriptionsForComponent . |
| SubscriptionsForComponent | Contient un objet pour chaque abonnement pour la collection Components parente. |
| TransientPublisherProperties | Contient un objet pour chaque propriété d’éditeur pour la collection parente TransientSubscriptions . |
| TransientSubscriberProperties | Contient un objet pour chaque propriété d’abonné pour la collection parente TransientSubscriptions . |
| TransientSubscriptions | Contient un objet pour chaque abonnement temporaire. |
| UsersInPartitionRole | Contient un objet pour chaque utilisateur dans le rôle de partition auquel la collection est liée. |
| UsersInRole | Contient un objet pour chaque utilisateur dans le rôle auquel la collection est liée. |
| WOWInprocServers | Contient une liste des serveurs in-process inscrits auprès du système pour les composants 32 bits sur les ordinateurs 64 bits. |
| WOWLegacyServers | Identique à la collection LegacyServers , sauf que cette collection est tirée du Registre 32 bits sur les ordinateurs 64 bits. |