共用方式為


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 來建立 COMAdminCatalogCollection 物件。 這會顯示在下列範例中,其中 「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