Udostępnij za pośrednictwem

Opis podsumowania klas COMAdmin

  • Artykuł

Istnieją trzy klasy udostępniane przez bibliotekę COMAdmin (comadmin.dll), z których każda implementuje podwójny interfejs COM. Obiekty utworzone na podstawie tych klas umożliwiają uzyskanie dostępu do wykazu, reprezentowanie kolekcji w wykazie oraz reprezentowanie elementów zawartych w kolekcjach.

COMAdminCatalog

Klasa COMAdminCatalog reprezentuje sam katalog. Obiekt utworzony na podstawie COMAdminCatalog jest podstawowym obiektem używanym w administracji programowej. Oprócz ustanowienia podstawowego połączenia z serwerem wykazu podczas tworzenia wystąpienia, COMAdminCatalog udostępnia metody, które umożliwiają wykonanie następujących czynności:

  • Pobieranie kolekcji w wykazie.
  • Nawiąż połączenie z serwerem wykazu na maszynie zdalnej.
  • Instalowanie, eksportowanie, uruchamianie, zamykanie i uzyskiwanie informacji dotyczących aplikacji COM+
  • Instalowanie składników w aplikacjach COM+ i uzyskiwanie informacji dotyczących składników.
  • Uruchamianie, zatrzymywanie lub odświeżanie usług uruchomionych na maszynie.
  • Odśwież, przywróć lub wykonaj kopię zapasową informacji o katalogu.

W wersji COM+ 1.0 klasa COMAdminCatalog implementuje interfejs ICOMAdminCatalog. W wersji COM+ 1.5 klasa COMAdminCatalog implementuje ICOMAdminCatalog2 jako interfejs domyślny.

COMAdminCatalogCollection

Klasa COMAdminCatalogCollection reprezentuje dowolną kolekcję w katalogu, podając ciąg nazewnictwa określonej kolekcji w czasie tworzenia wystąpienia obiektu. (Kolekcje katalogów dostępnych są nazwane w tabeli w kolekcji administracyjnych COM+). Obiekty są tworzone na podstawie tej klasy podczas pobierania kolekcji najwyższego poziomu przez wywołanie metody GetCollection obiektu COMAdminCatalog. Te obiekty są również tworzone podczas pobierania kolekcji podrzędnej przez wywołanie metody GetCollection obiektu kolekcji nadrzędnej. obiektów COMAdminCatalogCollection umożliwiają wykonanie następujących czynności:

  • Wyliczaj za pomocą elementów zawartych w kolekcji.
  • Pobierz element z kolekcji.
  • Dodaj lub usuń elementy do lub z kolekcji.
  • Zapisz lub odrzuć wszelkie oczekujące zmiany wprowadzone w kolekcji lub w elementach, które zawiera.
  • Pobierz inną kolekcję w wykazie.

Klasa COMAdminCatalogObject implementuje interfejs ICatalogCollection.

COMAdminCatalogObject

Klasa COMAdminCatalogObject reprezentuje dowolny element znajdujący się w kolekcji. Obiekty są tworzone na podstawie tej klasy podczas pobierania elementu za pośrednictwem właściwości Item obiektu kolekcji wykazu. Obiekty utworzone na podstawie klasy COMAdminCatalogObject umożliwiają wykonanie następujących czynności:

  • Pobieranie lub ustawianie właściwości obsługiwanych przez element używany do reprezentowania obiektu.
  • Uzyskaj informacje o elemencie i jego właściwościach.

Klasa COMAdminCatalogObject implementuje interfejsICatalogObject.

uzyskiwanie dostępu do katalogu COM+

Omówienie obiektów COMAdmin