Partilhar via


Descrição resumida das classes COMAdmin

Existem 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

O COMAdminCatalog classe 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ê o instancia, 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, encerre 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 na máquina.
  • Atualize, restaure ou faça backup das informações do catálogo.

Em COM+ 1.0, o classe COMAdminCatalog implementa o ICOMAdminCatalog interface. Em COM+ 1.5, o classe COMAdminCatalog implementa ICOMAdminCatalog2 como sua interface padrão.

COMAdminCatalogCollection

A classeCOMAdminCatalogCollection 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 COM+ Administration Collections.) Os objetos são criados a partir dessa classe ao recuperar uma coleção de nível superior chamando o método GetCollection do objetoCOMAdminCatalog. Esses objetos também são criados ao recuperar uma coleção filho chamando o GetCollection método de seu objeto de coleção pai. objetos COMAdminCatalogCollection permitem que você faça o seguinte:

  • Enumerar através dos itens contidos na coleção.
  • Recuperar um item da coleção.
  • Adicione ou remova itens de ou para a coleção.
  • Salve ou descarte quaisquer alterações pendentes feitas na coleção ou nos itens que ela contém.
  • Obtenha uma coleção diferente no catálogo.

O COMAdminCatalogObject classe implementa o ICatalogCollection interface.

COMAdminCatalogObject

O COMAdminCatalogObject classe representa qualquer item que está 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 do classe COMAdminCatalogObject permitem que você faça o seguinte:

  • Obtenha ou defina propriedades suportadas pelo item que o objeto está sendo usado para representar.
  • Obter informações sobre o item e suas propriedades.

O COMAdminCatalogObject classe implementa o ICatalogObject interface.

Acessando o catálogo COM+

Visão geral do de objetos COMAdmin