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 |
|
| Idl |
|