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+ 管理 タイプ ライブラリへの参照を追加します。 COMAdminCatalogCollection オブジェクトは、COMAdminCatalog オブジェクトで GetCollection を呼び出すことによって作成できます。 次の例では、"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 [デスクトップ アプリのみ]
ヘッダー	ComAdmin.h
IDL	ComAdmin.Idl

関連項目

COMAdminCatalog

COMAdminCatalogObject

ICatalogCollection