COM+ 管理コレクション

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

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

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

注意

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

 

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

コレクション階層

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

Diagram that shows the relationships among the collections.

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

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 コレクションと同じです。