COMAdminCatalogCollection 類別

發行項
06/13/2023

表示 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