Regroupements d’administration COM+

Les collections d’administration COM+ servent à conserver et organiser les données de configuration stockées dans le catalogue COM+. Les regroupements correspondent aux dossiers de l’arborescence de la console de l’outil d’administration Services de composants. Vous pouvez accéder à ces regroupements à l’aide des objets et des interfaces d’administration COM+.

Vous lancez l’administration par programme à 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 des éléments dans des collections à l’aide d’objets créés à partir de la classe COMAdminCatalogObject .

Les éléments d’une collection donnée exposent un jeu de propriétés cohérent. 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 en lecture seule par la suite.

Pour une introduction à l’administration par programme de COM+, consultez automatisation de l' administration com+.

Hiérarchie de collection

La figure suivante illustre les relations entre les collections. Les collections à l’extrême gauche (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 les zones jaunes) sont accessibles uniquement via 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 parent vers ses collections enfants.

Diagramme qui montre les relations entre les collections.

Les quatre regroupements suivants ne sont pas illustrés dans la figure : errorInfo, PropertyInfo, RelatedCollectionInfoet 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 racine 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 regroupements suivants sont pris 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 associé.
ComputerList Contient la liste des ordinateurs figurant dans le dossier ordinateurs de l’outil d’administration Services de composants.
DCOMProtocols Contient une liste des protocoles à utiliser par DCOM. Elle 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 sur les classes d’événements.
FilesForImport Récupère des informations de son fichier MSI sur une application qui peut être importée.
InprocServers Contient la liste des serveurs in-process inscrits auprès du système. Elle contient un objet pour chaque composant.
InterfacesForComponent Contient un objet pour chaque interface exposée par le composant auquel la collection est associée.
LegacyComponents Contient un objet pour chaque composant non configuré dans l’application à laquelle il est associé.
LegacyServers Identique à la collection InprocServers , à ceci près que cette collection comprend également des serveurs locaux.
LocalComputer Contient un objet unique qui contient les informations de paramètres au niveau de l’ordinateur pour l’ordinateur dont vous accédez au catalogue.
MethodsForInterface Contient un objet pour chaque méthode sur l’interface à laquelle la collection est associée.
Partitions Utilisé pour spécifier les applications contenues dans chaque partition.
PartitionUsers Utilisé pour 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é de serveur de publication pour la collection SubscriptionsForComponent parente.
RelatedCollectionInfo Récupère des informations sur d’autres collections relatives à la collection à partir de laquelle elle est appelée.
Rôles Contient un objet pour chaque rôle affecté à l’application à laquelle il est associé.
RolesForComponent Contient un objet pour chaque rôle assigné au composant auquel la collection est associée.
RolesForInterface Contient un objet pour chaque rôle assigné à l’interface à laquelle la collection est associée.
RolesForMethod Contient un objet pour chaque rôle assigné à la méthode à laquelle la collection est associée.
RolesForPartition Contient un objet pour chaque rôle affecté à la partition à laquelle la collection est associée.
Causes Contient les collections de niveau supérieur sur le catalogue.
SubscriberProperties Contient un objet pour chaque propriété d’abonné de la collection SubscriptionsForComponent parente.
SubscriptionsForComponent Contient un objet pour chaque abonnement de la collection de composants parents.
TransientPublisherProperties Contient un objet pour chaque propriété de serveur de publication pour la collection TransientSubscriptions parente.
TransientSubscriberProperties Contient un objet pour chaque propriété d’abonné de la collection TransientSubscriptions parente.
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 associée.
UsersInRole Contient un objet pour chaque utilisateur du rôle auquel la collection est associée.
WOWInprocServers Contient la 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 , hormis le fait que cette collection est extraite du Registre 32 bits sur les ordinateurs 64 bits.