COMAdminCatalogCollection 类

表示 COM+ 目录中的任何集合。 使用它枚举、添加、删除和检索集合中的项以及访问相关集合。

何时实现

此类由 COM+实现。

要求	值
接口	ICatalogCollection

何时使用

如果要以编程方式操作 COM+ 目录中的集合，请使用从 COMAdminCatalogCollection 类创建的对象。 这些集合对应于组件服务管理工具中的文件夹。 文件夹中的项对应于集合中的项，可以使用 从 COMAdminCatalogObject 类创建的对象来表示这些项。

有关目录及其属性上的集合的信息，请参阅 COM+ 管理集合。

有关 COM+ 编程管理简介，请参阅 自动化 COM+ 管理。

注解

不能直接创建 COMAdminCatalogCollection 对象。 若要使用此对象的方法，必须创建 COMAdminCatalog 对象，获取对 ICOMAdminCatalog 的引用，然后使用 ICOMAdminCatalog：：GetCollection 获取对表示顶级集合的 ICatalogCollection 接口的引用。 以下示例中显示了这一点，其中“TopCollection”必须替换为顶级 COM+ 管理集合之一的名称。

    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.

若要从 Microsoft Visual Basic使用此类，请添加对 COM+ 管理员类型库的引用。 可以通过对 COMAdminCatalog 对象调用 GetCollection 来创建 COMAdminCatalog 对象。 以下示例中显示了这一点，其中“TopCollection”必须替换为顶级 COM+ 管理集合之一的名称。

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

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	ComAdmin.h
IDL	ComAdmin.Idl

另请参阅

COMAdminCatalog

COMAdminCatalogObject

ICatalogCollection