COM+ 管理コレクション

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

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

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

注意

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

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

コレクション階層

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

コレクション間のリレーションシップを示す図。

図には 、ErrorInfo、PropertyInfo、RelatedCollectionInfo、および Root の 4 つのコレクションは示されません。 ErrorInfo コレクション、InprocServersWOWInprocServers (灰色のボックス) を除く、図のすべてのコレクションの子です。 PropertyInfo コレクションと RelatedCollectionInfo コレクションは、すべてのコレクションの子です。 ルート コレクション は、他のすべてのトップ レベル コレクションの親である、トップ レベルのコレクションです。 ただし、他のトップ レベルのコレクション にアクセス する前にルート コレクションにアクセスする必要はありません。

COMAdmin ライブラリ

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

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