Freigeben über


COMAdminCatalogCollection-Klasse

Stellt eine beliebige Auflistung im COM+-Katalog dar. Verwenden Sie sie zum Aufzählen, Hinzufügen, Entfernen und Abrufen von Elementen in einer Auflistung und zum Zugreifen auf verwandte Sammlungen.

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 Auflistung im COM+-Katalog programmgesteuert bearbeiten möchten. Diese Sammlungen entsprechen Ordnern im Verwaltungstool für Komponentendienste. Elemente in den Ordnern entsprechen Elementen in Auflistungen, die Sie mithilfe von Objekten darstellen können, die aus der COMAdminCatalogObject-Klasse erstellt wurden.

Informationen zu den Auflistungen im Katalog und ihren Eigenschaften finden Sie unter COM+-Verwaltungssammlungen.

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

Bemerkungen

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 ICOMAdminCatalog abrufen 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, wobei "TopCollection" durch den Namen einer com+-Verwaltungssammlung 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 aus Microsoft Visual Basic zu verwenden, fügen Sie einen Verweis auf die COM+-Admin-Typbibliothek hinzu. Ein COMAdminCatalogCollection-Objekt kann erstellt werden, indem GetCollection für ein COMAdminCatalog-Objekt aufgerufen wird. Dies wird im folgenden Beispiel gezeigt, wobei "TopCollection" durch den Namen einer com+-Verwaltungssammlung 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