COMAdminCatalogCollection (clase)

Representa cualquier colección del catálogo COM+. Úselo para enumerar, agregar, quitar y recuperar elementos de una colección y acceder a colecciones relacionadas.

Cuándo implementar

Com+implementa esta clase.

Requisito	Value
Interfaces	ICatalogCollection

Cuándo se usa

Use objetos creados a partir de la clase COMAdminCatalogCollection cuando desee manipular mediante programación una colección en el catálogo COM+. Estas colecciones corresponden a carpetas de la herramienta de administración servicios de componentes. Los elementos dentro de las carpetas corresponden a elementos de colecciones, que se pueden representar mediante objetos creados a partir de la clase COMAdminCatalogObject .

Para obtener información sobre las colecciones del catálogo y sus propiedades, vea Colecciones de administración de COM+.

Para obtener una introducción a la administración mediante programación de COM+, consulte Automatización de la administración de COM+.

Comentarios

No se puede crear directamente un objeto COMAdminCatalogCollection . Para usar los métodos de este objeto, debe crear un objeto COMAdminCatalog , obtener una referencia a ICOMAdminCatalog y, a continuación, usar ICOMAdminCatalog::GetCollection para obtener una referencia a una interfaz ICatalogCollection que representa una colección de nivel superior. Esto se muestra en el ejemplo siguiente, donde "TopCollection" debe reemplazarse por el nombre de una de las colecciones de administración COM+ de nivel 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 esta clase de Microsoft Visual Basic, agregue una referencia a la biblioteca de tipos com+ Administración. Se puede crear un objeto COMAdminCatalogCollection llamando a GetCollection en un objeto COMAdminCatalog . Esto se muestra en el ejemplo siguiente, donde "TopCollection" debe reemplazarse por el nombre de una de las colecciones de administración COM+ de nivel superior.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	ComAdmin.h
IDL	ComAdmin.Idl

Consulte también

COMAdminCatalog

COMAdminCatalogObject

ICatalogCollection