COMAdminCatalogCollection-Klasse

Stellt eine beliebige Auflistung im COM+-Katalog dar. Verwenden Sie es, um Elemente in einer Auflistung aufzuzählen, hinzuzufügen, zu entfernen und abzurufen und auf verwandte Sammlungen zuzugreifen.

Gründe für die Implementierung

Diese Klasse wird von COM+ implementiert.

Anforderung Wert
Schnittstellen ICatalogCollection

Verwendung

Verwenden Sie Objekte, die aus der COMAdminCatalogCollection-Klasse erstellt wurden, wenn Sie eine Sammlung programmgesteuert im COM+-Katalog bearbeiten möchten. Diese Sammlungen entsprechen Ordnern im Verwaltungstool Komponentendienste. Elemente in den Ordnern entsprechen Elementen in Sammlungen, die Sie mithilfe von Objekten darstellen können, die aus der COMAdminCatalogObject-Klasse erstellt wurden.

Informationen zu den Sammlungen im Katalog und deren Eigenschaften finden Sie unter COM+ Administration Collections.

Eine Einführung in die programmgesteuerte Verwaltung von COM+ finden Sie unter Automatisieren der COM+-Verwaltung.

Hinweise

Sie können kein COMAdminCatalogCollection-Objekt direkt erstellen. Um die Methoden dieses Objekts zu verwenden, müssen Sie ein COMAdminCatalog-Objekt erstellen, einen Verweis auf ICOMAdminCatalogabrufen und dann ICOMAdminCatalog::GetCollection verwenden, um einen Verweis auf eine ICatalogCollection-Schnittstelle abzurufen, die eine Auflistung der obersten Ebene darstellt. Dies wird im folgenden Beispiel gezeigt, in dem "TopCollection" durch den Namen einer der COM+-Verwaltungssammlungen der obersten Ebene ersetzt werden muss.

    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.

Um diese Klasse von Microsoft Visual Basic zu verwenden, fügen Sie einen Verweis auf die COM+-Administratortypbibliothek hinzu. Ein COMAdminCatalogCollection-Objekt kann erstellt werden, indem GetCollection für ein COMAdminCatalog-Objekt aufgerufen wird. Dies wird im folgenden Beispiel gezeigt, in dem "TopCollection" durch den Namen einer der COM+-Verwaltungssammlungen der obersten Ebene ersetzt werden muss.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
ComAdmin.h
Idl
ComAdmin.Idl

Siehe auch

COMAdminCatalog

COMAdminCatalogObject

ICatalogCollection