Format d’ensemble de propriétés sérialisées du stockage structuré

Les jeux de propriétés persistants fournissent une option permettant de stocker des données au sein d’entités de système de fichiers. Pour les créer et les gérer, il est recommandé d’utiliser les interfaces IPropertySetStorage et IPropertyStorage décrites dans Propriétés et Ensembles de propriétés.

Les jeux de propriétés sont composés d’une section étiquetée de valeurs, la section étant identifiée de manière unique par un identificateur de format (FMTID). Chaque propriété se compose d’un identificateur de propriété et d’un indicateur de type qui représente une valeur. Chaque valeur stockée dans un jeu de propriétés a un identificateur de propriété unique qui distingue la propriété. L’indicateur de type décrit la représentation des données dans la valeur.

Lorsque vous utilisez les interfaces IPropertySetStorage et IPropertyStorage , vous n’avez pas besoin de gérer la structure de format de jeu de propriétés sérialisées COM. Pour plus d’informations, consultez les rubriques répertoriées :

Tous les éléments de données d’un jeu de propriétés sont stockés dans une représentation Intel (c’est-à-dire dans l’ordre des octets peu endiens).

COM définit un format de données sérialisé standard pour les jeux de propriétés. Lors de la gestion du format sérialisé, et non avec les interfaces, les jeux de propriétés présentent les caractéristiques suivantes :

• Les jeux de propriétés permettent à différentes applications de créer leurs propres jeux de propriétés indépendants pour servir l’application.
• Les jeux de propriétés peuvent être stockés dans un seul instance IStream ou dans un instance IStorage qui contient plusieurs flux. Les jeux de propriétés sont simplement un autre type de données qui peut être stocké sous de nombreuses formes différentes d’un stockage en mémoire ou sur disque. Pour plus d’informations et les conventions recommandées pour la création du nom de chaîne pour l’objet de stockage, consultez Conventions de nommage des objets de stockage.
• Les jeux de propriétés permettent d’inclure un dictionnaire de noms d’affichage qui décrivent le contenu. Un ensemble de conventions pour le choix des noms de propriétés est recommandé. Pour plus d’informations sur ce dictionnaire facultatif, consultez Identificateurs de propriétés réservées, y compris l’ID de propriété 0.

Le flux de jeu de propriétés est divisé en trois parties principales :

• En-tête
• PAIRE FORMATID/décalage
• Section contenant les valeurs réelles du jeu de propriétés

La longueur totale du flux de jeu de propriétés doit être inférieure ou égale à 256 000. Les sections suivantes, En-tête d’ensemble de propriétés, Identificateur de format/Paire de décalage et Section (y compris Identificateurs de propriétés/Paires de décalage), avec des rubriques de prise en charge, décrivent les composants individuels qui composent le format de données du jeu de propriétés.

Notes

Les versions précédentes de ce document décrivaient des extensions au flux de jeu de propriétés avec plusieurs sections autorisées, mais cela a été modifié pour fournir une section dans le flux de propriétés. La seule exception est les ensembles de propriétés DocumentSummaryInformation et UserDefined.