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 [僅限桌面應用程式] |
標頭 |
|
Idl |
|