Formato de conjunto de propiedades serializado 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 IPropertySetStorage e 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.

Cuando se usan las interfaces IPropertySetStorage e IPropertyStorage , no es necesario controlar la estructura de formato del conjunto de propiedades serializada COM. Para obtener más información, consulte los temas enumerados:

Todos los elementos de datos de un conjunto de propiedades se almacenan en 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 atender la aplicación.
• Los conjuntos de propiedades se pueden almacenar en una sola instancia de IStream o en una instancia de IStorage que contenga varias secuencias. Los conjuntos de propiedades son simplemente otro tipo de datos que se puede almacenar en muchas formas diferentes de 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 reservados, incluido el identificador 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 000. En las secciones siguientes, Encabezado de conjunto de propiedades, Par de formato de identificador/desplazamiento y 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.

Nota:

Las versiones anteriores de este documento describieron extensiones en la secuencia del conjunto de propiedades con más de una sección permitida, pero que se ha revisado para proporcionar una sección en el flujo de propiedades. La única excepción es Los conjuntos de propiedades DocumentSummaryInformation y UserDefined.