COM+ 管理コレクション

  • [アーティクル]

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

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

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

Note

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

 

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

コレクションの階層

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

Diagram that shows the relationships among the collections.

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