Freigeben über

COM+-Verwaltungssammlungen

  • Artikel

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.

Diagramm, das die Beziehungen zwischen den Sammlungen zeigt.

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.