Interfaz IPropertySetStorage (propidl.h)

Artículo
08/25/2023

La interfaz IPropertySetStorage crea, abre, elimina y enumera los almacenamientos del conjunto de propiedades que admiten instancias de la interfaz IPropertyStorage . La interfaz IPropertyStorage administra un único conjunto de propiedades en un subobjeto de almacenamiento de propiedades; y la interfaz IPropertySetStorage administra el almacenamiento de grupos de dichos conjuntos de propiedades. Cualquier entidad del sistema de archivos puede admitir IPropertySetStorage que se implementa actualmente en el objeto de archivo compuesto COM.

Las interfaces IPropertySetStorage e IPropertyStorage proporcionan una manera uniforme de crear y administrar conjuntos de propiedades, independientemente de que estos conjuntos residan o no en un objeto de almacenamiento que admita IStorage. Cuando se llama a través de un objeto que admite IStorage (como archivos estructurados y compuestos) o IStream, los conjuntos de propiedades creados se ajustan al formato del conjunto de propiedades COM, que se describe con detalle en Formato de conjunto de propiedades serializados de almacenamiento estructurado. De forma similar, las propiedades escritas mediante IStorage en el formato del conjunto de propiedades COM son visibles a través de IPropertySetStorage e IPropertyStorage.

Los métodos IPropertySetStorage identifican los conjuntos de propiedades a través de un identificador único global (GUID) denominado identificador de formato (FMTID). El FMTID de un conjunto de propiedades identifica los identificadores de propiedad del conjunto de propiedades, su significado y las restricciones de los valores. El FMTID de un conjunto de propiedades también debe proporcionar los medios para manipular ese conjunto de propiedades. Solo puede existir una instancia de un FMTID determinado cada vez dentro de un único almacenamiento de propiedades.

Herencia

La interfaz IPropertySetStorage hereda de la interfaz IUnknown . IPropertySetStorage también tiene estos tipos de miembros:

Métodos

La interfaz IPropertySetStorage tiene estos métodos.


IPropertySetStorage::Create Crea y abre un nuevo conjunto de propiedades en el objeto de almacenamiento del conjunto de propiedades.
IPropertySetStorage::D elete El método Delete elimina uno de los conjuntos de propiedades contenidos en el objeto de almacenamiento del conjunto de propiedades.
IPropertySetStorage::Enum El método Enum crea un objeto enumerador que contiene información sobre los conjuntos de propiedades almacenados en este almacenamiento del conjunto de propiedades. A cambio, este método proporciona un puntero al puntero IEnumSTATPROPSETSTG en el objeto enumerador.
IPropertySetStorage::Open Abre un conjunto de propiedades contenido en el objeto de almacenamiento del conjunto de propiedades.

Comentarios

Nota Hay una excepción a lo anterior en el conjunto de propiedades DocumentSummaryInformation y UserDefined. Este conjunto de propiedades es único en que puede tener dos secciones establecidas de propiedades en una única secuencia subyacente. Este conjunto de propiedades se describe en Los conjuntos de propiedades DocumentSummaryInformation y UserDefined. La primera sección es el conjunto de propiedades DocumentSummaryInformation. La segunda sección es el conjunto de propiedades UserDefined. Cada sección se identifica mediante un identificador de formato único (FMTID). Por ejemplo, FMTID_DocSummaryInformation y FMTID_UserDefined propiedad establecida. El hecho de que estos dos conjuntos de propiedades pueden existir en una sola secuencia afecta al comportamiento de la interfaz IPropertySetStorage .

Cuando se llama a IPropertySetStorage::Create para crear el conjunto de propiedades UserDefined, la primera sección se crea automáticamente. Una vez creado el FMTID_UserDefinedProperties, no es necesario crear FMTID_DocSummaryInformation, pero se puede abrir con una llamada a IPropertySetStorage::Open. La creación de la primera sección no crea automáticamente la segunda sección y no es posible abrir ambas secciones simultáneamente.

Al llamar a IPropertySetStorage::D elete, para eliminar la primera sección, ambas secciones se eliminarán. En otras palabras, llamar a IPropertySetStorage::D elete con FMTID_DocSummaryInformation hace que la sección y la sección FMTID_UserDefinedProperties se eliminen. Sin embargo, la eliminación de la segunda sección no elimina automáticamente la primera sección.

Cuando se usa IPropertySetStorage::Enum para enumerar conjuntos de propiedades, no se enumera el conjunto de propiedades UserDefined.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	propidl.h (include Objbase.h)