Interfaz IPropertyStorage (propidl.h)

Artículo
08/25/2023

La interfaz IPropertyStorage administra las propiedades persistentes de un único conjunto de propiedades. Las propiedades persistentes constan de información que se puede almacenar de forma persistente en un conjunto de propiedades, como la información de resumen asociada a un archivo. Esto contrasta con las propiedades en tiempo de ejecución asociadas a Controls and Automation, que se pueden usar para afectar al comportamiento del sistema. Use los métodos de la interfaz IPropertySetStorage para crear o abrir un conjunto de propiedades persistente. Una instancia de la interfaz IPropertySetStorage puede administrar cero o más instancias de IPropertyStorage .

Cada propiedad de un conjunto de propiedades se identifica mediante un identificador de propiedad (ID), un valor de ULONG de cuatro bytes único para ese conjunto. También puede asignar un nombre de cadena a una propiedad a través de la interfaz IPropertyStorage .

Los identificadores de propiedad difieren de los identificadores de envío que se usan en las etiquetas de nombre de propiedad despidido de Automation. Una diferencia es que el uso de uso general de los valores de identificador de propiedad cero y uno está prohibido en IPropertyStorage, mientras que no existe ninguna restricción de este tipo en IDispatch. Además, aunque hay una superposición significativa entre los tipos de datos de los valores de propiedad que se pueden usar en IPropertyStorage e IDispatch, los conjuntos de propiedades no son idénticos. Los tipos de datos de propiedad persistente usados en los métodos IPropertyStorage se definen en la estructura PROPVARIANT .

La interfaz IPropertyStorage se puede usar para tener acceso a conjuntos de propiedades simples y nomples. Los conjuntos de propiedades nomple pueden contener varios tipos de propiedades complejos que no se pueden mantener en un conjunto de propiedades simple. Para obtener más información, vea Almacenamiento y Stream objetos para un conjunto de propiedades.

Herencia

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

Métodos

La interfaz IPropertyStorage tiene estos métodos.


IPropertyStorage::Commit El método IPropertyStorage::Commit guarda los cambios realizados en un objeto de almacenamiento de propiedades en el objeto de almacenamiento primario.
IPropertyStorage::D eleteMultiple El método IPropertyStorage::D eleteMultiple elimina tantas propiedades indicadas como existen en este conjunto de propiedades.
IPropertyStorage::D eletePropertyNames El método DeletePropertyNames elimina los nombres de cadena especificados del conjunto de propiedades actual. (IPropertyStorage.DeletePropertyNames)
IPropertyStorage::Enum El método IPropertyStorage::Enum crea un objeto enumerador diseñado para enumerar datos de tipo STATPROPSTG, que contiene información sobre el conjunto de propiedades actual.
IPropertyStorage::ReadMultiple El método IPropertyStorage::ReadMultiple lee las propiedades especificadas del conjunto de propiedades actual.
IPropertyStorage::ReadPropertyNames El método IPropertyStorage::ReadPropertyNames recupera los nombres de cadena existentes para los identificadores de propiedad especificados.
IPropertyStorage::Revert El método IPropertyStorage::Revert descarta todos los cambios en el conjunto de propiedades con nombre desde que se abrió por última vez o descarta los cambios confirmados por última vez en el conjunto de propiedades.
IPropertyStorage::SetClass El método IPropertyStorage::SetClass asigna un nuevo CLSID al objeto de almacenamiento de propiedades actual y almacena persistentemente el CLSID con el objeto .
IPropertyStorage::SetTimes El método IPropertyStorage::SetTimes establece las horas de modificación, acceso y creación de este conjunto de propiedades, si es compatible con la implementación.
IPropertyStorage::Stat El método IPropertyStorage::Stat recupera información sobre el conjunto de propiedades open actual. (IPropertyStorage.Stat)
IPropertyStorage::WriteMultiple El método IPropertyStorage::WriteMultiple escribe un grupo de propiedades especificado en el conjunto de propiedades actual.
IPropertyStorage::WritePropertyNames El método IPropertyStorage::WritePropertyNames asigna las cadenas IPropertyStoragenames a una matriz especificada de identificadores de propiedad en el conjunto de propiedades actual.

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, Propidlbase.h)