Formato de conjunto de propiedades serializados de almacenamiento estructurado

Los conjuntos de propiedades persistentes proporcionan una opción para almacenar datos dentro de las entidades del sistema de archivos. Se recomienda que, para crearlos y administrarlos, use las interfaces de IPropertySetStor age y las interfaces de IPropertyStorage descritas en Propiedades y conjuntos de propiedades.

Los conjuntos de propiedades se componen de una sección etiquetada de valores, con la sección identificada de forma única por un identificador de formato (FMTID). Cada propiedad consta de un identificador de propiedad y un indicador de tipo que representa un valor. Cada valor almacenado en un conjunto de propiedades tiene un identificador de propiedad único que distingue la propiedad. El indicador de tipo describe la representación de los datos en el valor.

Al usar la IPropertySetStorage y interfaces de IPropertyStorage, no es necesario controlar la estructura de formato del conjunto de propiedades serializado COM. Para obtener más información, consulte los temas enumerados:

Todos los elementos de datos de un conjunto de propiedades se almacenan en la representación intel (es decir, en orden de bytes little-endian).

COM define un formato de datos estándar serializado para conjuntos de propiedades. Al controlar el formato serializado y no con las interfaces, los conjuntos de propiedades tienen las siguientes características:

• Los conjuntos de propiedades permiten que diferentes aplicaciones creen sus propios conjuntos de propiedades independientes para servir a la aplicación.
• Los conjuntos de propiedades se pueden almacenar en una única instancia de IStreamo en una instancia dede IStorageque contiene varias secuencias. Los conjuntos de propiedades son simplemente otro tipo de datos que se puede almacenar en muchas formas diferentes de un almacenamiento en memoria o en disco. Para obtener más información y convenciones recomendadas para crear el nombre de cadena para el objeto de almacenamiento, consulte Convenciones de nomenclatura de objetos de almacenamiento.
• Los conjuntos de propiedades permiten incluir un diccionario de nombres para mostrar que describen el contenido. Se recomienda un conjunto de convenciones para elegir nombres de propiedad. Para obtener más información sobre este diccionario opcional, vea identificadores de propiedad reservada, incluido id. de propiedad 0.

La secuencia del conjunto de propiedades se divide en tres partes principales:

• Encabezado
• PAR FORMATID/offset
• Sección que contiene los valores reales del conjunto de propiedades

La longitud total de la secuencia del conjunto de propiedades debe ser menor o igual que 256 0000. En las secciones siguientes, encabezado de conjunto de propiedades, formato de par de identificador y desplazamientoy sección (incluidos identificadores de propiedad/pares de desplazamiento), con temas auxiliares, se describen los componentes individuales que componen el formato de datos del conjunto de propiedades.