Interfaz IPropertyStorage (propidlbase.h)
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 Controles y automatización, 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 usados en las etiquetas de nombre de propiedad dispid 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 dicha restricción 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 no simples. 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 Storage and Stream Objects for a Property Set.
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 de las propiedades indicadas como existen en un conjunto de propiedades. |
|
IPropertyStorage::D eletePropertyNames El método IPropertyStorage::D eletePropertyNames elimina los nombres de cadena especificados del conjunto de propiedades actual. |
|
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 los tiempos 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 especificado de propiedades en el conjunto de propiedades actual. |
|
IPropertyStorage::WritePropertyNames El método IPropertyStorage::WritePropertyNames asigna la cadena 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 | propidlbase.h (include Objbase.h, Propidlbase.h) |
Consulte también
Implementación de archivos compuestos de IPropertyStorage
Implementación del sistema de archivos IPropertyStorage-NTFS
Implementación independiente de IPropertyStorage