Coleções de administração COM+

As coleções de administração do COM+ servem para manter e organizar os dados de configuração armazenados no catálogo COM+. As coleções correspondem às pastas na árvore de console da ferramenta de administração de serviços de componentes. Você pode acessar essas coleções usando os objetos e as interfaces de administração do COM+.

Você inicia a administração programática usando objetos criados a partir da classe COMAdminCatalog , você representa todas as coleções no catálogo usando objetos criados a partir da classe COMAdminCatalogCollection e representa itens em coleções usando objetos criados a partir da classe COMAdminCatalogObject .

Os itens em uma determinada coleção expõem um conjunto consistente de propriedades. Por exemplo, cada item na coleção de componentes representa um componente e os itens na coleção de componentes expõem as mesmas propriedades usadas para configurar um componente. Essas propriedades podem ser acessadas usando a classe COMAdminCatalogObject .

Observação

As propriedades com acesso WriteOnce são ReadWrite ao usar o método Add antes de usar SaveChanges e são ReadOnly posteriormente.

Para obter uma introdução à administração programática do COM+, consulte automatizando a administração do com+.

Hierarquia de coleção

A figura a seguir ilustra as relações entre as coleções. As coleções na extrema esquerda (em caixas brancas e cinzas) são coleções de nível superior, que são acessadas chamando o método GetCollection de um objeto criado a partir da classe COMAdminCatalog . As coleções restantes (em caixas amarelas) só podem ser acessadas por meio de sua coleção pai, chamando o método GetCollection do objeto COMAdminCatalogCollection que representa seu pai. As setas apontam de uma coleção pai para suas coleções filho.

Diagrama que mostra as relações entre as coleções.

As quatro coleções a seguir não são ilustradas na figura: errorInfo, PropertyInfo, RelatedCollectionInfoe root. A coleção errorInfo é um filho de cada coleção na figura, exceto InprocServers e WOWInprocServers (em caixas cinzas). As coleções PropertyInfo e RelatedCollectionInfo são filhas de cada coleção. A coleção raiz é uma coleção de nível superior que é o pai de todas as outras coleções de nível superior. No entanto, não é necessário acessar a coleção raiz antes de acessar outras coleções de nível superior.

Biblioteca COMAdmin

As coleções a seguir têm suporte na biblioteca COMAdmin.

Coleção Descrição
ApplicationCluster Contém uma lista dos servidores no cluster de aplicativos.
ApplicationInstances Contém um objeto para cada instância de um aplicativo COM+ em execução.
Aplicativos Contém um objeto para cada aplicativo COM+ instalado no computador local.
Componentes Contém um objeto para cada componente no aplicativo ao qual ele está relacionado.
Computerlist Contém uma lista dos computadores encontrados na pasta computadores da ferramenta de administração de serviços de componentes.
DCOMProtocols Contém uma lista dos protocolos a serem usados pelo DCOM. Ele contém um objeto para cada protocolo.
ErrorInfo Recupera informações de erro estendidas referentes a métodos que lidam com vários objetos.
EventClassesForIID Recupera informações sobre classes de evento.
FilesForImport Recupera informações de seu arquivo MSI sobre um aplicativo que pode ser importado.
InprocServers Contém uma lista dos servidores em processo registrados no sistema. Ele contém um objeto para cada componente.
InterfacesForComponent Contém um objeto para cada interface exposta pelo componente ao qual a coleção está relacionada.
LegacyComponents Contém um objeto para cada componente não configurado no aplicativo ao qual ele está relacionado.
LegacyServers Idêntico à coleção InprocServers , exceto que essa coleção também inclui servidores locais.
LocalComputer Contém um único objeto que contém informações de configurações de nível de computador para o computador cujo catálogo você está acessando.
MethodsForInterface Contém um objeto para cada método na interface à qual a coleção está relacionada.
Partições Usado para especificar os aplicativos contidos em cada partição.
PartitionUsers Usado para especificar os usuários contidos em cada partição.
PropertyInfo Recupera informações sobre as propriedades com suporte de uma coleção especificada.
Editorproperties Contém um objeto para cada propriedade do Publicador da coleção SubscriptionsForComponent pai.
RelatedCollectionInfo Recupera informações sobre outras coleções relacionadas à coleção da qual ela é chamada.
Funções Contém um objeto para cada função atribuída ao aplicativo ao qual ele está relacionado.
RolesForComponent Contém um objeto para cada função atribuída ao componente ao qual a coleção está relacionada.
RolesForInterface Contém um objeto para cada função atribuída à interface à qual a coleção está relacionada.
RolesForMethod Contém um objeto para cada função atribuída ao método ao qual a coleção está relacionada.
RolesForPartition Contém um objeto para cada função atribuída à partição à qual a coleção está relacionada.
Básica Contém as coleções de nível superior no catálogo.
Assinantes Contém um objeto para cada propriedade de assinante para a coleção SubscriptionsForComponent pai.
SubscriptionsForComponent Contém um objeto para cada assinatura para a coleção de componentes pai.
TransientPublisherProperties Contém um objeto para cada propriedade do Publicador da coleção TransientSubscriptions pai.
TransientSubscriberProperties Contém um objeto para cada propriedade de assinante para a coleção TransientSubscriptions pai.
TransientSubscriptions Contém um objeto para cada assinatura transitória.
UsersInPartitionRole Contém um objeto para cada usuário na função de partição à qual a coleção está relacionada.
UsersInRole Contém um objeto para cada usuário na função ao qual a coleção está relacionada.
WOWInprocServers Contém uma lista dos servidores em processo registrados com o sistema para componentes de 32 bits em computadores de 64 bits.
WOWLegacyServers Idêntico à coleção LegacyServers , exceto que essa coleção é desenhada do registro de 32 bits em computadores de 64 bits.