Coleções de administração COM+

As coleções de administração COM+ servem para armazenar e organizar dados de configuração armazenados no catálogo COM+. As coleções correspondem a pastas na árvore de console da ferramenta de administração dos Serviços de Componentes. Você pode acessar essas coleções usando os objetos e interfaces de administração COM+.

Você inicia a administração programática usando objetos criados a partir da classeCOMAdminCatalog, representa todas as coleções no catálogo usando objetos criados a partir da classeCOMAdminCatalogCollectione representa itens em coleções usando objetos criados a partir da classeCOMAdminCatalogObject.

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

Observação

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

 

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 extremidade 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 classeCOMAdminCatalog. As coleções restantes (em caixas amarelas) só podem ser acessadas por meio de sua coleção pai, chamando o GetCollection método do COMAdminCatalogCollection objeto que representa seu pai. As setas apontam de uma coleção pai para suas coleções filhas.

As quatro coleções a seguir não são ilustradas na figura: ErrorInfo, PropertyInfo, RelatedCollectionInfoe Root. A coleção ErrorInfo é filha de todas as coleções na figura, exceto InprocServers e WOWInprocServers (em caixas cinza). As coleções PropertyInfo e RelatedCollectionInfo são filhos de todas as coleções. A coleção Root é 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 Root antes de acessar outras coleções de nível superior.

Biblioteca COMAdmin

As coleções a seguir são suportadas pela 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.
Aplicações	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 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 sobre métodos que lidam com vários objetos.
EventClassesForIID	Recupera informações sobre classes de eventos.
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 ao coleção de 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 no nível do 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 suportadas por uma coleção especificada.
PublisherProperties	Contém um objeto para cada propriedade de editor para o pai coleção de SubscriptionsForComponent.
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 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.
Root	Contém as coleções de nível superior no catálogo.
SubscriberProperties	Contém um objeto para cada propriedade de assinante para o pai coleção de SubscriptionsForComponent.
SubscriptionsForComponent	Contém um objeto para cada assinatura para o pai Components coleção.
TransientPublisherProperties	Contém um objeto para cada propriedade de editor para o pai coleção de TransientSubscriptions.
TransientSubscriberProperties	Contém um objeto para cada propriedade de assinante para o pai coleção de TransientSubscriptions.
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 à qual a coleção está relacionada.
WOWInprocServers	Contém uma lista dos servidores em processo registrados no sistema para componentes de 32 bits em computadores de 64 bits.
WOWLegacyServers	Idêntica à coleçãoLegacyServers, exceto que essa coleção é extraída do registro de 32 bits em computadores de 64 bits.