COM+ 管理コレクション

COM+ 管理コレクションは、COM+ カタログに格納されている構成データを保持および整理するのに役立ちます。 このコレクションは、コンポーネント サービス管理ツールのコンソール ツリー内のフォルダーに対応します。 これらのコレクションには、COM+ 管理オブジェクトとインターフェイスを使用してアクセスできます。

プログラムによる管理は、COMAdminCatalog クラスから作成されたオブジェクトを使用して開始します。COMAdminCatalogCollection クラスから作成されたオブジェクトを使用してカタログ内のすべてのコレクションを表し、COMAdminCatalogObject クラスから作成されたオブジェクトを使用してコレクション内の項目を表します。

特定のコレクション内の項目は、一貫性のあるプロパティのセットを公開します。 たとえば、Components コレクション内のそれぞれの項目は 1 つのコンポーネントを表し、Components コレクション内のそれらの項目はコンポーネントの構成に使用されるのと同じプロパティを公開します。 これらのプロパティには、COMAdminCatalogObject クラスを使用してアクセスすることができます。

Note

WriteOnce アクセス権を持つプロパティは、SaveChanges を使用する前に Add メソッドを使用しているときに ReadWrite になり、後で ReadOnly になります。

 

COM+ のプログラムによる管理の概要については、「COM+ 管理の自動化」を参照してください。

コレクションの階層

次の図は、コレクション間の関係を示しています。 左端のコレクション (白と灰色のボックス) は最上位レベルのコレクションであり、COMAdminCatalog クラスから作成されたオブジェクトの GetCollection メソッドを呼び出すことによってアクセスされます。 残りのコレクション (黄色のボックス) は、親を表す COMAdminCatalogCollection オブジェクトの GetCollection メソッドを呼び出すことによって、親コレクションを介してのみアクセスできます。 矢印は、親コレクションからその子コレクションを指しています。

図には、ErrorInfo、PropertyInfo、RelatedCollectionInfo、Root の 4 つのコレクションは示されていません。 ErrorInfo コレクションは、InprocServers と WOWInprocServers (灰色のボックス) を除く、図の中のすべてのコレクションの子です。 PropertyInfo コレクションと RelatedCollectionInfo コレクションは、すべてのコレクションの子です。 Root コレクションは、他のすべての最上位コレクションの親である最上位のコレクションです。 ただし、他の最上位のコレクションにアクセスする前に Root コレクションにアクセスする必要はありません。

COMAdmin ライブラリ

COMAdmin ライブラリでは、次のコレクションがサポートされています。

コレクション	説明
ApplicationCluster	アプリケーション クラスター内のサーバーの一覧が含まれています。
ApplicationInstances	実行中の COM+ アプリケーションの各インスタンスのオブジェクトを格納します。
アプリケーション	ローカル コンピューターにインストールされている各 COM+ アプリケーションのオブジェクトを格納します。
Components	関連付けられているアプリケーション内の各コンポーネントのオブジェクトを格納します。
ComputerList	コンポーネント サービス管理ツールの [コンピューター] フォルダーにあるコンピューターの一覧が含まれます。
DCOMProtocols	DCOM で使用されるプロトコルの一覧が含まれます。 各プロトコルのオブジェクトを格納します。
ErrorInfo	複数のオブジェクトを処理するメソッドに関する拡張エラー情報を取得します。
EventClassesForIID	イベント クラスに関する情報を取得します。
FilesForImport	インポートできるアプリケーションに関する情報を MSI ファイルから取得します。
InprocServers	システムに登録されているインプロセス サーバーの一覧が含まれます。 各コンポーネントのオブジェクトを格納します。
InterfacesForComponent	コレクションが関連付けられているコンポーネントによって公開される各インターフェイスのオブジェクトを格納します。
LegacyComponents	関連付けられているアプリケーション内の未構成の各コンポーネントのオブジェクトを格納します。
LegacyServers	このコレクションは、ローカル サーバーも含まれていることを除き、InprocServers コレクションと同じです。
LocalComputer	カタログにアクセスするコンピューターのコンピューター レベルの設定情報を保持する 1 つのオブジェクトを格納します。
MethodsForInterface	コレクションが関連付けられているインターフェイス上の各メソッドのオブジェクトを格納します。
パーティション	各パーティションに含まれるアプリケーションを指定するために使用されます。
PartitionUsers	各パーティションに含まれるをユーザーを指定するために使用されます。
PropertyInfo	指定したコレクションがサポートするプロパティに関する情報を取得します。
PublisherProperties	親 SubscriptionsForComponent コレクションの各パブリッシャー プロパティのオブジェクトを格納します。
RelatedCollectionInfo	呼び出し元のコレクションに関連する他のコレクションに関する情報を取得します。
ロール	関連付けられているアプリケーションに割り当てられた各ロールのオブジェクトを格納します。
RolesForComponent	コレクションが関連付けられているコンポーネントに割り当てられた各ロールのオブジェクトを格納します。
RolesForInterface	コレクションが関連付けられているインターフェイスに割り当てられた各ロールのオブジェクトを格納します。
RolesForMethod	コレクションが関連付けられているメソッドに割り当てられた各ロールのオブジェクトを格納します。
RolesForPartition	コレクションが関連付けられているパーティションに割り当てられた各ロールのオブジェクトを格納します。
Root	カタログの最上位レベルのコレクションが含まれます。
SubscriberProperties	親 SubscriptionsForComponent コレクションの各サブスクライバー プロパティのオブジェクトを格納します。
SubscriptionsForComponent	親 Components コレクションの各サブスクリプションのオブジェクトを格納します。
TransientPublisherProperties	親 TransientSubscriptions コレクションの各パブリッシャー プロパティのオブジェクトを格納します。
TransientSubscriberProperties	親 TransientSubscriptions コレクションの各サブスクライバー プロパティのオブジェクトを格納します。
TransientSubscriptions	一時的なサブスクリプションごとのオブジェクトを格納します。
UsersInPartitionRole	コレクションが関連付けられているパーティション ロールの各ユーザーのオブジェクトを格納します。
UsersInRole	コレクションが関連付けられているロールの各ユーザーのオブジェクトを格納します。
WOWInprocServers	64 ビット コンピューター上の 32 ビット コンポーネントのシステムに登録されているインプロセス サーバーの一覧が含まれます。
WOWLegacyServers	このコレクションは、64 ビット コンピューター上の 32 ビット レジストリから取得されることを除いて、LegacyServers コレクションと同じです。