Coleções de administração COM+
As coleções de administração COM+ servem para armazenar e organizar os 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 classe COMAdminCatalog , representa todas as coleções no catálogo usando objetos criados 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 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 Automating COM+ Administration.
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.
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 todas as coleções na figura, exceto InprocServers e WOWInprocServers (em caixas cinzas). As coleções PropertyInfo e RelatedCollectionInfo são filhos de cada coleção. 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 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 dos 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. |
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 compatíveis com uma coleção especificada. |
PublisherProperties | Contém um objeto para cada propriedade do publicador para a 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. |
Root | Contém as coleções de nível superior no catálogo. |
SubscriberProperties | 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 de Componentes pai. |
TransientPublisherProperties | Contém um objeto para cada propriedade publisher para a coleção transientSubscriptions pai. |
TransientSubscriberProperties | Contém um objeto para cada propriedade de assinante para a coleção pai 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 com o sistema para componentes de 32 bits em computadores de 64 bits. |
WOWLegacyServers | Idêntico à coleção LegacyServers , exceto que essa coleção é extraiada do registro de 32 bits em computadores de 64 bits. |