Format de jeu de propriétés structurés Stockage sérialisé

Les jeux de propriétés persistantes offrent une option permettant de stocker des données au sein d’entités de système de fichiers. Il est recommandé de les créer et de les gérer, d’utiliser les interfaces IPropertySetStorage et IPropertyStorage décrites dans Properties and Property Sets.

Les jeux de propriétés sont composés d’une section balisée de valeurs, avec la section 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 du jeu de propriétés sérialisée 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 la représentation Intel (autrement dit, dans l’ordre d’octet little-endian).

COM définit un format de données standard sérialisé pour les jeux de propriétés. Lorsque vous gérez le 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 une seule instance IStream ou dans une instance IStorage qui contient plusieurs flux. Les jeux de propriétés sont simplement un autre type de données qui peut être stocké dans 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 Stockage Conventions d’affectation de noms d’objet.
  • 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 choisir des noms de propriétés est recommandé. Pour plus d’informations sur ce dictionnaire facultatif, consultez Identificateurs de propriété réservés, 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/offset
  • Section contenant les valeurs réelles du jeu de propriétés

La longueur globale du flux de jeu de propriétés doit être inférieure ou égale à 256 Ko. Les sections suivantes, Property Set Header, Format Identifier/Offset Pair, and Section (y compris Property Identifiers/Offset Pairs), avec les 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 ont décrit les extensions du flux de jeu de propriétés avec plusieurs sections autorisées, mais qui ont été révisées pour fournir une section dans le flux de propriétés. La seule exception est Les ensembles de propriétés DocumentSummaryInformation et UserDefined.