COM+ 管理コレクションは、COM+ カタログに格納されている構成データを保持および整理するのに役立ちます。 コレクションは、Component Services 管理ツールのコンソール ツリー内のフォルダーに対応します。 これらのコレクションには、COM+ 管理オブジェクトとインターフェイスを使用してアクセスできます。
プログラムによる管理は、COMAdminCatalog クラスから作成されたオブジェクトを使用して開始し、COMAdminCatalogCollection クラスから作成されたオブジェクトを使用してカタログ内のすべてのコレクションを表し、COMAdminCatalogObject クラスから作成されたオブジェクトを使用してコレクション内の項目を表します。
特定のコレクション内の項目は、一貫性のあるプロパティのセットを公開します。 たとえば、Components コレクション内のすべての項目はコンポーネントを表し、Components コレクション内の項目は、コンポーネントの構成に使用されるのと同じプロパティを公開します。 これらのプロパティには、COMAdminCatalogObject クラスを使用してアクセスできます。
手記
WriteOnce アクセス権を持つプロパティは、SaveChanges を使用する前に Add メソッドを使用しているときに ReadWrite になり、後で ReadOnly になります。
COM+ のプログラムによる管理の概要については、「COM+ 管理を自動化する」を参照してください。
コレクション階層
次の図は、コレクション間のリレーションシップを示しています。 左端のコレクション (白と灰色のボックス) は最上位レベルのコレクションであり、COMAdminCatalog クラスから作成されたオブジェクトの GetCollection メソッドを呼び出すことによってアクセスされます。 残りのコレクション (黄色のボックス) には、親を表す COMAdminCatalogCollection オブジェクトの GetCollection メソッドを呼び出すことによって、親コレクションを介してのみアクセスできます。 矢印は、親コレクションからその子コレクションを指しています。
次の 4 つのコレクションは、図に示されていません。ErrorInfo、PropertyInfo、RelatedCollectionInfo、およびルートします。 ErrorInfo コレクションは、inprocServersと WOWInprocServers(灰色のボックス)除く、図のすべてのコレクションの子です。 PropertyInfo コレクションと RelatedCollectionInfo コレクションは、すべてのコレクションの子です。 ルート コレクションは、他のすべての最上位コレクションの親である最上位レベルのコレクションです。 ただし、他の最上位のコレクションにアクセスする前に、ルート コレクションにアクセスする必要はありません。
COMAdmin ライブラリ
COMAdmin ライブラリでは、次のコレクションがサポートされています。
| 徴収 | 形容 |
|---|---|
| ApplicationClusterの | アプリケーション クラスター内のサーバーの一覧が含まれています。 |
| ApplicationInstancesの | 実行中の COM+ アプリケーションの各インスタンスのオブジェクトを格納します。 |
| アプリケーションの | ローカル コンピューターにインストールされている各 COM+ アプリケーションのオブジェクトが含まれます。 |
| コンポーネント | 関連付けられているアプリケーション内の各コンポーネントのオブジェクトを格納します。 |
| ComputerList | コンポーネント サービス管理ツールの Computers フォルダーにあるコンピューターの一覧が含まれます。 |
| 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 | 親 Components コレクションの各サブスクリプションのオブジェクトを格納します。 |
| TransientPublisherPropertiesの | コレクションの親 TransientSubscriptions の各パブリッシャー プロパティのオブジェクト 格納します。 |
| TransientSubscriberProperties | コレクションの親 TransientSubscriptions の各サブスクライバー プロパティのオブジェクト 格納します。 |
| TransientSubscriptions | 一時的なサブスクリプションごとにオブジェクトを格納します。 |
| UsersInPartitionRole | コレクションが関連付けられているパーティション ロール内の各ユーザーのオブジェクトを格納します。 |
| UsersInRole | コレクションが関連付けられているロール内の各ユーザーのオブジェクトを格納します。 |
| WOWInprocServersの | 64 ビット コンピューター上の 32 ビット コンポーネントのシステムに登録されているインプロセス サーバーの一覧が含まれています。 |
| WOWLegacyServersの | LegacyServers コレクションと同じですが、このコレクションは 64 ビット コンピューター上の 32 ビット レジストリから取得されます。 |