Groupes de propriétés partagées
Pour éviter les collisions de noms entre les propriétés créées par différents objets, le gestionnaire de propriétés partagées (SPM) utilise des groupes de propriétés partagés. Un groupe de propriétés partagées est simplement un espace de noms pour un ensemble de propriétés partagées. Chaque propriété d’un groupe de propriétés partagé se compose d’un nom, d’une valeur et d’une position dans le groupe de propriétés partagés. Le nom ou la position peut être utilisé pour récupérer la valeur de la propriété. Vous pouvez accéder à des groupes de propriétés partagés et les créer via le gestionnaire de groupes de propriétés partagées.
Le modèle objet SPM est illustré dans l’illustration suivante.
Voici les interfaces du gestionnaire de propriétés partagées :
ISharedPropertyGroupManager permet de créer des groupes de propriétés partagées et d’obtenir l’accès à des groupes de propriétés partagés existants. Vous pouvez accéder à l’interface ISharedPropertyGroupManager en créant un instance de l’objet SharedPropertyGroupManager à l’aide de IObjectContext::CreateInstance ou CoCreateInstance.
ISharedPropertyGroup est utilisé pour créer et accéder aux propriétés partagées dans un groupe de propriétés partagés. Vous pouvez accéder à l’interface ISharedPropertyGroup en créant un objet SharedPropertyGroup avec la méthode ISharedPropertyGroupManager::CreatePropertyGroup . Comme pour tout objet COM, vous devez libérer un objet SharedPropertyGroup lorsque vous avez terminé de l’utiliser.
ISharedProperty est utilisé pour définir ou récupérer la valeur d’une propriété partagée. Une propriété partagée peut contenir n’importe quel type de données qui peut être représenté par un variant. Vous pouvez accéder à l’interface ISharedProperty en créant un objet SharedProperty avec la méthode ISharedPropertyGroup::CreateProperty ou la méthode ISharedPropertyGroup::CreatePropertyByPosition . Un objet SharedProperty ne peut être créé ou accessible qu’à partir d’un objet SharedPropertyGroup . Là encore, vous devez libérer un objet SharedProperty lorsque vous avez terminé de l’utiliser.
Rubriques connexes