Classe COMAdminCatalogCollection

Representa qualquer coleção no catálogo COM+. Use-o para enumerar, adicionar, remover e recuperar itens em uma coleção e acessar coleções relacionadas.

Quando implementar

Essa classe é implementada pelo COM+.

Requisito	Valor
Interfaces	ICatalogCollection

Quando usar

Use objetos criados a partir da classe COMAdminCatalogCollection quando quiser manipular programaticamente uma coleção no catálogo COM+. Essas coleções correspondem a pastas na ferramenta de administração dos Serviços de Componentes. Os itens dentro das pastas correspondem a itens em coleções, que você pode representar usando objetos criados a partir da classe COMAdminCatalogObject .

Para obter informações sobre as coleções no catálogo e suas propriedades, consulte Coleções de Administração COM+.

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

Comentários

Você não pode criar diretamente um objeto COMAdminCatalogCollection . Para usar os métodos desse objeto, você deve criar um objeto COMAdminCatalog , obter uma referência a ICOMAdminCatalog e, em seguida, usar ICOMAdminCatalog::GetCollection para obter uma referência a uma interface ICatalogCollection que representa uma coleção de nível superior. Isso é mostrado no exemplo a seguir, em que "TopCollection" deve ser substituído pelo nome de uma das coleções de administração COM+ de nível superior.

    HRESULT hr = CoCreateInstance(CLSID_COMAdminCatalog, NULL, 
      CLSCTX_INPROC_SERVER, IID_IUnknown, (void**)&pUnknown);
    if (FAILED (hr)) exit(0);  // Replace with specific error handling.
    hr = pUnknown->QueryInterface(IID_ICOMAdminCatalog, 
      (void**)&pCatalog); 
    if (FAILED (hr)) exit(0);  // Replace with specific error handling.
    hr = pCatalog->GetCollection(L"TopCollection", 
      (IDispatch**)&pTopColl);
    if (FAILED (hr)) exit(0);  // Replace with specific error handling.

Para usar essa classe do Microsoft Visual Basic, adicione uma referência à Biblioteca de Tipos de Administração COM+. Um objeto COMAdminCatalogCollection pode ser criado chamando GetCollection em um objeto COMAdminCatalog . Isso é mostrado no exemplo a seguir, em que "TopCollection" deve ser substituído pelo nome de uma das coleções de administração COM+ de nível superior.

Dim objCatalog As COMAdmin.COMAdminCatalog
Set objCatalog = CreateObject("COMAdmin.COMAdminCatalog")
Dim objTopCollection As COMAdmin.COMAdminCatalogCollection
Set objTopCollection = objCatalog.GetCollection("TopCollection")

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	ComAdmin.h
IDL	ComAdmin.Idl

Confira também

COMAdminCatalog

COMAdminCatalogObject

ICatalogCollection