Grupos de propiedades compartidas

Para evitar colisiones de nombres entre propiedades creadas por diferentes objetos, el administrador de propiedades compartidas (SPM) usa grupos de propiedades compartidas. Un grupo de propiedades compartidas es simplemente un espacio de nombres para un conjunto de propiedades compartidas. Cada propiedad de un grupo de propiedades compartidas consta de un nombre, un valor y una posición dentro del grupo de propiedades compartidas. El nombre o la posición se pueden usar para recuperar el valor de la propiedad. Puede acceder y crear grupos de propiedades compartidas a través del administrador de grupos de propiedades compartidas.

El modelo de objetos SPM se muestra en la ilustración siguiente.

A continuación se muestran las interfaces del administrador de propiedades compartidas:

• ISharedPropertyGroupManager se usa para crear grupos de propiedades compartidas y obtener acceso a grupos de propiedades compartidas existentes. Puede acceder a la interfaz ISharedPropertyGroupManager mediante la creación de una instancia del objeto SharedPropertyGroupManager mediante IObjectContext::CreateInstance o CoCreateInstance.

• ISharedPropertyGroup se usa para crear y acceder a las propiedades compartidas en un grupo de propiedades compartidas. Para acceder a la interfaz ISharedPropertyGroup , cree un objeto SharedPropertyGroup con el método ISharedPropertyGroupManager::CreatePropertyGroup . Al igual que con cualquier objeto COM, debe liberar un objeto SharedPropertyGroup cuando haya terminado de usarlo.

• ISharedProperty se usa para establecer o recuperar el valor de una propiedad compartida. Una propiedad compartida puede contener cualquier tipo de datos que se pueda representar mediante un variant. Puede acceder a la interfaz ISharedProperty mediante la creación de un objeto SharedProperty con el método ISharedPropertyGroup::CreateProperty o el método ISharedPropertyGroup::CreatePropertyByPosition . Se puede crear o acceder a un objeto SharedProperty solo desde un objeto SharedPropertyGroup . De nuevo, debe liberar un objeto SharedProperty cuando haya terminado de usarlo.

Temas relacionados

Administrador de propiedades compartidas de COM+