COM+-Verwaltungssammlungen

Die COM+-Verwaltungssammlungen dienen zum Speichern und Organisieren von Konfigurationsdaten, die im COM+-Katalog gespeichert sind. Die Sammlungen entsprechen Ordnern in der Konsolenstruktur des Verwaltungstool Komponentendienste. Sie können mithilfe der COM+-Verwaltungsobjekte und -Schnittstellen auf diese Sammlungen zugreifen.

Sie initiieren die programmgesteuerte Verwaltung mithilfe von Objekten, die aus der COMAdminCatalog-Klasse erstellt wurden. Sie stellen alle Sammlungen im Katalog mithilfe von Objekten dar, die aus der COMAdminCatalogCollection-Klasse erstellt wurden, und Sie stellen Elemente in Auflistungen mithilfe von Objekten dar, die aus der COMAdminCatalogObject-Klasse erstellt wurden.

Die Elemente in einer bestimmten Auflistung machen einen konsistenten Satz von Eigenschaften verfügbar. Beispielsweise stellt jedes Element in der Components-Auflistung eine Komponente dar, und die Elemente in der Components-Auflistung machen die gleichen Eigenschaften verfügbar, die zum Konfigurieren einer Komponente verwendet wurden. Auf diese Eigenschaften kann mithilfe der COMAdminCatalogObject-Klasse zugegriffen werden.

Hinweis

Eigenschaften mit WriteOnce-Zugriff sind ReadWrite, während die Add-Methode vor der Verwendung von SaveChanges verwendet wird, und sind anschließend ReadOnly.

Eine Einführung in die programmgesteuerte Verwaltung von COM+ finden Sie unter Automatisieren der COM+-Verwaltung.

Sammlungshierarchie

Die folgende Abbildung veranschaulicht die Beziehungen zwischen den Auflistungen. Die Auflistungen ganz links (in weißen und grauen Feldern) sind Sammlungen der obersten Ebene, auf die durch Aufrufen der GetCollection-Methode eines Objekts zugegriffen wird, das aus der COMAdminCatalog-Klasse erstellt wurde. Auf die verbleibenden Auflistungen (in gelben Feldern) kann nur über die übergeordnete Auflistung zugegriffen werden, indem die GetCollection-Methode des COMAdminCatalogCollection-Objekts aufgerufen wird, das das übergeordnete Element darstellt. Die Pfeile zeigen von einer übergeordneten Auflistung auf die untergeordneten Auflistungen.

Diagramm, das die Beziehungen zwischen den Auflistungen zeigt.

Die folgenden vier Auflistungen sind in der Abbildung nicht dargestellt: ErrorInfo, PropertyInfo, RelatedCollectionInfound Root. Die ErrorInfo-Sammlung ist ein untergeordnetes Element jeder Sammlung in der Abbildung, mit Ausnahme von InprocServers und WOWInprocServers (in grauen Feldern). Die PropertyInfo- und RelatedCollectionInfo-Auflistungen sind children jeder Auflistung. Die Root-Auflistung ist eine Auflistung der obersten Ebene, die allen anderen Auflistungen der obersten Ebene über-übergeordnete Auflistungen ist. Es ist jedoch nicht erforderlich, vor dem Zugriff auf andere Sammlungen der obersten Ebene auf die Stammsammlung zu zugreifen.

COMAdmin-Bibliothek

Die folgenden Sammlungen werden von der COMAdmin-Bibliothek unterstützt.

Sammlung BESCHREIBUNG
ApplicationCluster Enthält eine Liste der Server im Anwendungscluster.
ApplicationInstances Enthält ein -Objekt für jede Instanz einer ausgeführten COM+-Anwendung.
Anwendungen Enthält ein -Objekt für jede COM+-Anwendung, die auf dem lokalen Computer installiert ist.
Komponenten Enthält ein -Objekt für jede Komponente in der Anwendung, mit der sie verknüpft ist.
ComputerList Enthält eine Liste der Computer, die sich im Ordner Computer des Verwaltungstool Komponentendienste befinden.
DCOMProtocols Enthält eine Liste der Protokolle, die von DCOM verwendet werden sollen. Sie enthält ein -Objekt für jedes Protokoll.
ErrorInfo Ruft erweiterte Fehlerinformationen zu Methoden ab, die mehrere Objekte behandeln.
EventClassesForIID Ruft Informationen zu Ereignisklassen ab.
FilesForImport Ruft Informationen zu einer Anwendung, die importiert werden kann, aus der MSI-Datei ab.
InprocServers Enthält eine Liste der Prozessserver, die beim System registriert sind. Sie enthält ein -Objekt für jede Komponente.
InterfacesForComponent Enthält ein -Objekt für jede Schnittstelle, die von der Komponente verfügbar gemacht wird, mit der die Auflistung verknüpft ist.
LegacyComponents Enthält ein -Objekt für jede nicht konfigurierte Komponente in der Anwendung, mit der sie verknüpft ist.
LegacyServers Identisch mit der InprocServers-Auflistung, mit dem Ausnahme, dass diese Sammlung auch lokale Server enthält.
LocalComputer Enthält ein einzelnes -Objekt, das Einstellungsinformationen auf Computerebene für den Computer enthält, auf den Sie zugreifen.
MethodsForInterface Enthält ein -Objekt für jede Methode auf der Schnittstelle, mit der die Auflistung verknüpft ist.
Partitionen Wird verwendet, um die anwendungen anzugeben, die in jeder Partition enthalten sind.
PartitionUsers Wird verwendet, um die in jeder Partition enthaltenen Benutzer anzugeben.
Propertyinfo Ruft Informationen zu den Eigenschaften ab, die von einer angegebenen Auflistung unterstützt werden.
PublisherProperties Enthält ein -Objekt für jede Herausgebereigenschaft für die übergeordnete SubscriptionsForComponent-Auflistung.
RelatedCollectionInfo Ruft Informationen zu anderen Auflistungen ab, die mit der Auflistung verknüpft sind, aus der sie aufgerufen wird.
Rollen Enthält ein -Objekt für jede Rolle, die der Anwendung zugewiesen ist, mit der sie verknüpft ist.
RolesForComponent Enthält ein -Objekt für jede Rolle, die der Komponente zugewiesen ist, mit der die Auflistung verknüpft ist.
RolesForInterface Enthält ein -Objekt für jede Rolle, die der Schnittstelle zugewiesen ist, mit der die Auflistung verknüpft ist.
RolesForMethod Enthält ein -Objekt für jede Rolle, die der Methode zugewiesen ist, mit der die Auflistung verknüpft ist.
RolesForPartition Enthält ein -Objekt für jede Rolle, die der Partition zugewiesen ist, mit der die Auflistung verknüpft ist.
Wurzel Enthält die Auflistungen der obersten Ebene im Katalog.
SubscriberProperties Enthält ein -Objekt für jede Abonnenteneigenschaft für die übergeordnete SubscriptionsForComponent-Auflistung.
SubscriptionsForComponent Enthält ein -Objekt für jedes Abonnement für die übergeordnete Components-Auflistung.
TransientPublisherProperties Enthält ein -Objekt für jede Herausgebereigenschaft für die übergeordnete TransientSubscriptions-Auflistung.
TransientSubscriberProperties Enthält ein -Objekt für jede Abonnenteneigenschaft für die übergeordnete TransientSubscriptions-Auflistung.
TransientSubscriptions Enthält ein -Objekt für jedes vorübergehende Abonnement.
UsersInPartitionRole Enthält ein -Objekt für jeden Benutzer in der Partitionsrolle, mit der die Auflistung verknüpft ist.
UsersInRole Enthält ein -Objekt für jeden Benutzer in der Rolle, mit der die Auflistung verknüpft ist.
WOWInprocServers Enthält eine Liste der Prozessserver, die beim System für 32-Bit-Komponenten auf 64-Bit-Computern registriert sind.
WOWLegacyServers Identisch mit der LegacyServers-Sammlung, außer dass diese Auflistung aus der 32-Bit-Registrierung auf 64-Bit-Computern gezeichnet wird.