Descrição resumida das classes COMAdmin
Há três classes fornecidas pela biblioteca COMAdmin (comadmin.dll), cada uma das quais implementa uma interface dupla COM. Você usa objetos criados a partir dessas classes para obter acesso ao catálogo, para representar coleções no catálogo e para representar os itens contidos nas coleções.
COMAdminCatalog
A classe COMAdminCatalog representa o próprio catálogo. Um objeto criado a partir de COMAdminCatalog é o objeto fundamental que você usa na administração programática. Além de estabelecer a conexão básica com o servidor de catálogo quando você instanciá-lo, COMAdminCatalog fornece métodos que permitem que você faça o seguinte:
- Obtenha coleções no catálogo.
- Conecte-se ao servidor de catálogo em uma máquina remota.
- Instale, exporte, inicie, desligue e obtenha informações sobre aplicativos COM+.
- Instale componentes em aplicativos COM+ e obtenha informações sobre componentes.
- Iniciar, parar ou atualizar serviços em execução no computador.
- Atualizar, restaurar ou fazer backup das informações do catálogo.
No COM+ 1.0, a classe COMAdminCatalog implementa a interface ICOMAdminCatalog. No COM+ 1.5, a classe COMAdminCatalog implementa ICOMAdminCatalog2 como sua interface padrão.
COMAdminCatalogCollection
A classe COMAdminCatalogCollection representa qualquer coleção no catálogo, fornecendo uma cadeia de caracteres nomeando a coleção específica no momento da instanciação do objeto. (As coleções de catálogo disponíveis são nomeadas na tabela em Coleções de Administração COM+.) Os objetos são criados a partir dessa classe ao recuperar uma coleção de nível superior chamando o método GetCollection do objeto COMAdminCatalog. Esses objetos também são criados ao recuperar uma coleção filho chamando o método GetCollection de seu objeto de coleção pai. Os objetos COMAdminCatalogCollection permitem que você faça o seguinte:
- Enumere através dos itens contidos na coleção.
- Recuperar um item da coleção.
- Adicionar ou remover itens de ou para a coleção.
- Salve ou descarte quaisquer alterações pendentes feitas na coleção ou nos itens nela contidos.
- Obtenha uma coleção diferente no catálogo.
A classe COMAdminCatalogObject implementa a interface ICatalogCollection.
COMAdminCatalogObject
A classe COMAdminCatalogObject representa qualquer item contido em uma coleção. Os objetos são criados a partir dessa classe ao obter um item por meio da propriedade Item de um objeto de coleção de catálogo. Os objetos criados a partir da classe COMAdminCatalogObject permitem que você faça o seguinte:
- Obter ou definir propriedades suportadas pelo item que o objeto está sendo usado para representar.
- Obtenha informações sobre o item e suas propriedades.
A classe COMAdminCatalogObject implementa a interface ICatalogObject.
Tópicos relacionados