共有プロパティ グループ

異なるオブジェクトによって作成されたプロパティ間の名前の競合を防ぐために、共有プロパティ マネージャー (SPM) は共有プロパティ グループを使用します。 共有プロパティ グループは、一連の共有プロパティの単なる名前空間です。 共有プロパティ グループ内の各プロパティは、名前、値、および共有プロパティ グループ内の位置で構成されます。 名前または位置を使用して、プロパティ値を取得できます。 共有プロパティ グループ マネージャーを使用して、共有プロパティ グループにアクセスして作成できます。

SPM オブジェクト モデルは、次の図のようになります。

共有プロパティ マネージャーのインターフェイスを次に示します。

• ISharedPropertyGroupManager は、共有プロパティ グループを作成し、既存の共有プロパティ グループへのアクセスを取得するために使用されます。 IObjectContext::CreateInstance または CoCreateInstanceを使用して SharedPropertyGroupManager オブジェクトのインスタンスを作成することで、ISharedPropertyGroupManager インターフェイスにアクセスできます。

• ISharedPropertyGroup は、共有プロパティ グループ内の共有プロパティを作成してアクセスするために使用されます。 ISharedPropertyGroupManager::CreatePropertyGroup メソッドを使用して SharedPropertyGroup オブジェクトを作成することで、ISharedPropertyGroup インターフェイスにアクセスできます。 他の COM オブジェクトと同様に、 SharedPropertyGroup オブジェクトの使用が完了したら、そのオブジェクトを解放する必要があります。

• ISharedProperty は、共有プロパティの値を設定または取得するために使用されます。 共有プロパティには、Variant で表すことができる任意のデータ型を含めることができます。 ISharedPropertyGroup::CreateProperty メソッドまたは ISharedPropertyGroup::CreatePropertyByPosition メソッドを使用して SharedProperty オブジェクトを作成することで、 ISharedProperty インターフェイスにアクセスできます。 SharedProperty オブジェクトは、 SharedPropertyGroup オブジェクト内からのみ作成またはアクセスできます。 ここでも、 SharedProperty オブジェクトの使用が完了したら、そのオブジェクトを解放する必要があります。

関連トピック

COM+ 共有プロパティ マネージャー