Kelas COMAdminCatalogCollection

Artikel
06/13/2023

Mewakili koleksi apa pun dalam katalog COM+. Gunakan untuk menghitung, menambahkan, menghapus, dan mengambil item dalam koleksi dan untuk mengakses koleksi terkait.

Kapan harus menerapkan

Kelas ini diimplementasikan oleh COM+.

Persyaratan	Nilai
Antarmuka	ICatalogCollection

Waktu menggunakan

Gunakan objek yang dibuat dari kelas COMAdminCatalogCollection saat Anda ingin memanipulasi koleksi secara terprogram di katalog COM+. Koleksi ini sesuai dengan folder di alat administrasi Layanan Komponen. Item di dalam folder sesuai dengan item dalam koleksi, yang dapat Anda wakili dengan menggunakan objek yang dibuat dari kelas COMAdminCatalogObject .

Untuk informasi mengenai koleksi pada katalog dan propertinya, lihat Koleksi Administrasi COM+.

Untuk pengenalan administrasi TERPROGRAM COM+, lihat Mengotomatiskan Administrasi COM+.

Keterangan

Anda tidak dapat langsung membuat objek COMAdminCatalogCollection . Untuk menggunakan metode objek ini, Anda harus membuat objek COMAdminCatalog , mendapatkan referensi ke ICOMAdminCatalog, lalu menggunakan ICOMAdminCatalog::GetCollection untuk mendapatkan referensi ke antarmuka ICatalogCollection yang mewakili koleksi tingkat atas. Ini ditunjukkan dalam contoh berikut, di mana "TopCollection" harus diganti dengan nama salah satu koleksi administrasi COM+ tingkat atas.

    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.

Untuk menggunakan kelas ini dari Microsoft Visual Basic, tambahkan referensi ke COM+ Admin Type Library. Objek COMAdminCatalogCollection dapat dibuat dengan memanggil GetCollection pada objek COMAdminCatalog . Ini ditunjukkan dalam contoh berikut, di mana "TopCollection" harus diganti dengan nama salah satu koleksi administrasi COM+ tingkat atas.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	ComAdmin.h
IDL	ComAdmin.Idl

Lihat juga

COMAdminCatalog
COMAdminCatalogObject
ICatalogCollection

Bagikan melalui