Zusammenfassungsbeschreibung der COMAdmin-Klassen
Es gibt drei Klassen, die von der COMAdmin-Bibliothek (comadmin.dll) bereitgestellt werden, von denen jede eine COM-Dual-Schnittstelle implementiert. Sie verwenden objekte, die aus diesen Klassen erstellt wurden, um Zugriff auf den Katalog zu erhalten, Sammlungen im Katalog und die in Auflistungen enthaltenen Elemente zu darstellen.
COMAdminCatalog
Die COMAdminCatalog-Klasse stellt den Katalog selbst dar. Ein aus COMAdminCatalog erstelltes Objekt ist das grundlegende Objekt, das Sie in der programmgesteuerten Verwaltung verwenden. ComAdminCatalog stellt beim Instanziieren nicht nur die grundlegende Verbindung mit dem Katalogserver, sondern auch Methoden zur Verfügung, mit denen Sie folgende Schritte ausführen können:
- Sammlungen für den Katalog erhalten.
- Verbinden mit dem Katalogserver auf einem Remotecomputer.
- Installieren, Exportieren, Starten, Herunterfahren und Abrufen von Informationen zu COM+-Anwendungen.
- Installieren Sie Komponenten in COM+-Anwendungen, und erhalten Sie Informationen zu Komponenten.
- Starten, Beenden oder Aktualisieren von Diensten, die auf dem Computer ausgeführt werden.
- Aktualisieren, Wiederherstellen oder Sichern von Kataloginformationen.
In COM+ 1.0 implementiert die COMAdminCatalog-Klasse die ICOMAdminCatalog-Schnittstelle. In COM+ 1.5 implementiert die COMAdminCatalog-Klasse ICOMAdminCatalog2 als Standardschnittstelle.
COMAdminCatalogCollection
Die COMAdminCatalogCollection-Klasse stellt eine beliebige Sammlung im Katalog dar, indem sie eine Zeichenfolge angibt, die die bestimmte Sammlung zum Zeitpunkt der Objekt instanziierung begibt. (Verfügbare Katalogsammlungen werden in der Tabelle unter COM+-Verwaltungssammlungen benannt.) Objekte werden aus dieser Klasse erstellt, wenn eine Auflistung der obersten Ebene durch Aufrufen der GetCollection-Methode des COMAdminCatalog-Objekts abgerufen wird. Diese Objekte werden auch erstellt, wenn eine untergeordnete Auflistung durch Aufrufen der GetCollection-Methode des übergeordneten Auflistungsobjekts abgerufen wird. COMAdminCatalogCollection-Objekte ermöglichen Folgendes:
- Enumerieren Sie die in der Auflistung enthaltenen Elemente.
- Ruft ein Element aus der Auflistung ab.
- Hinzufügen oder Entfernen von Elementen zur oder aus der Auflistung.
- Speichern oder verwerfen Sie alle ausstehenden Änderungen an der Auflistung oder an den elementen, die sie enthält.
- Sie erhalten eine andere Auflistung im Katalog.
Die COMAdminCatalogObject-Klasse implementiert die ICatalogCollection-Schnittstelle.
COMAdminCatalogObject
Die COMAdminCatalogObject-Klasse stellt jedes Element dar, das in einer Auflistung enthalten ist. Objekte werden aus dieser Klasse erstellt, wenn ein Element über die Item-Eigenschaft eines Katalogsammlungsobjekts erhalten wird. Objekte, die mit der COMAdminCatalogObject-Klasse erstellt wurden, ermöglichen Folgendes:
- Dient zum Erhalten oder Festlegen von Eigenschaften, die von dem Element unterstützt werden, für das das -Objekt verwendet wird.
- Abrufen von Informationen zum Element und seinen Eigenschaften.
Die COMAdminCatalogObject-Klasse implementiert die ICatalogObject-Schnittstelle.