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 Component Services-Verwaltungstools. 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 Sammlungen 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 dieselben Eigenschaften verfügbar, die zum Konfigurieren einer Komponente verwendet werden. Auf diese Eigenschaften kann mithilfe der COMAdminCatalogObject-Klasse zugegriffen werden.

Hinweis

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

 

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

Auflistungshierarchie

Die folgende Abbildung veranschaulicht die Beziehungen zwischen den Sammlungen. Die Sammlungen 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 restlichen Sammlungen (in gelben Feldern) kann nur über die übergeordnete Auflistung zugegriffen werden, indem die GetCollection-Methode des COMAdminCatalogCollection-Objekts aufgerufen wird, das das übergeordnete Objekt darstellt. Die Pfeile zeigen von einer übergeordneten Auflistung auf ihre untergeordneten Auflistungen.

Die folgenden vier Sammlungen sind in der Abbildung nicht dargestellt: ErrorInfo, PropertyInfo, RelatedCollectionInfo und Root. Die ErrorInfo-Auflistung ist ein untergeordnetes Element jeder Auflistung in der Abbildung mit Ausnahme von InprocServers und WOWInprocServers (in grauen Feldern). Die PropertyInfo - und RelatedCollectionInfo-Auflistungen sind untergeordnete Elemente jeder Auflistung. Die Root-Auflistung ist eine Auflistung der obersten Ebene, die das übergeordnete Element aller anderen Sammlungen der obersten Ebene ist. Es ist jedoch nicht erforderlich, auf die Stammsammlung zuzugreifen, bevor Sie auf andere Sammlungen der obersten Ebene 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 instance 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 im Ordner Computer des Component Services-Verwaltungstools.
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 sich mit mehreren Objekten befassen.
EventClassesForIID	Ruft Informationen zu Ereignisklassen ab.
FilesForImport	Ruft Informationen aus der MSI-Datei zu einer Anwendung ab, die importiert werden kann.
InprocServer	Enthält eine Liste der prozessinternen Server, 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.
LegacyServer	Identisch mit der InprocServers-Auflistung , mit der Ausnahme, dass diese Sammlung auch lokale Server enthält.
LocalComputer	Enthält ein einzelnes Objekt, das Einstellungen auf Computerebene für den Computer enthält, auf dessen Katalog 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 Benutzer anzugeben, die in jeder Partition enthalten sind.
Propertyinfo	Ruft Informationen zu den Eigenschaften ab, die von einer angegebenen Auflistung unterstützt werden.
PublisherProperties	Enthält ein Objekt für jede Verlegereigenschaft für die übergeordnete SubscriptionsForComponent-Auflistung .
RelatedCollectionInfo	Ruft Informationen zu anderen Sammlungen ab, die sich auf die Auflistung beziehen, aus der sie aufgerufen wird.
Rollen	Enthält ein Objekt für jede Rolle, die der Anwendung zugewiesen ist, der sie zugeordnet 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, der die Auflistung zugeordnet ist.
Wurzel	Enthält die Sammlungen der obersten Ebene im Katalog.
AbonnentenEigenschaften	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 Verlegereigenschaft 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 dem die Auflistung verknüpft ist.
UsersInRole	Enthält ein Objekt für jeden Benutzer in der Rolle, mit der die Auflistung verknüpft ist.
WOWInprocServer	Enthält eine Liste der prozessinternen Server, die beim System für 32-Bit-Komponenten auf 64-Bit-Computern registriert sind.
WOWLegacyServers	Identisch mit der LegacyServers-Auflistung , mit der Ausnahme, dass diese Sammlung aus der 32-Bit-Registrierung auf 64-Bit-Computern gezeichnet wird.