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 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 classe COMAdminCatalog, representa quaisquer 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 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 de COM+, consulte Automatizando a administração de 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 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 filhas.
As quatro coleções a seguir não são ilustradas na figura: ErrorInfo, PropertyInfo, RelatedCollectionInfo e 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 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.
| Cobrança | Descrição |
|---|---|
| ApplicationCluster | Contém uma lista dos servidores no cluster de aplicativos. |
| Instâncias de aplicativo | 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. |
| Lista de Computadores | 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 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. |
| Componentes Legados | Contém um objeto para cada componente não configurado no aplicativo ao qual ele está relacionado. |
| Servidores Legados | Idêntico à coleção InprocServers, exceto que essa coleção também inclui servidores locais. |
| Computador Local | Contém um único objeto que contém informações de configurações no nível do computador para o computador cujo catálogo você está acessando. |
| MétodosForInterface | 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. |
| Informações da Propriedade: | Recupera informações sobre as propriedades que uma coleção especificada suporta. |
| Propriedades do Publisher | Contém um objeto para cada propriedade do editor para a coleção SubscriptionsForComponent pai. |
| RelatedCollectionInfo | Recupera informações sobre outras coleções relacionadas à coleção da qual ele é chamado. |
| Funções | Contém um objeto para cada função atribuída ao aplicativo ao qual está relacionada. |
| RolesForComponent | Contém um objeto para cada função atribuída ao componente ao qual a coleção está relacionada. |
| FunçõesForInterface | 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. |
| Propriedades do Assinante | Contém um objeto para cada propriedade de assinante para a coleção SubscriptionsForComponent pai. |
| SubscriptionsForComponent | Contém um objeto para cada assinatura da coleção Components pai. |
| TransientPublisherProperties | Contém um objeto para cada propriedade de editor para a coleção TransientSubscriptions pai. |
| TransientSubscriberProperties | Contém um objeto para cada propriedade de assinante para a coleção TransientSubscriptions pai. |
| Assinaturas transitórias | 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. |
| WOWLegacyServidores | Idêntico à coleção LegacyServers , exceto que essa coleção é extraída do registro de 32 bits em computadores de 64 bits. |