Implémentations des ensembles de propriétés dans COM

Bien que le potentiel d’utilisation des jeux de propriétés persistants ne soit pas entièrement exploité, il existe actuellement deux utilisations principales :

• Stockage d’informations récapitulatives avec un objet tel qu’un document
• Transfert de données de propriété entre des objets

Les jeux de propriétés COM ont été conçus pour stocker des données adaptées à la représentation sous la forme d’une collection de valeurs affinées de taille moyenne. Les jeux de données trop volumineux pour que cela soit possible doivent être divisés en flux, stockages et/ou ensembles de propriétés distincts. Le format de données du jeu de propriétés COM n’était pas destiné à remplacer une base de données de nombreux objets minuscules.

COM fournit des implémentations des interfaces de jeu de propriétés pour différents objets, ainsi que trois fonctions d’assistance. La section suivante décrit certaines caractéristiques de performances de ces implémentations. Pour plus d’informations sur des interfaces spécifiques et sur la façon d’obtenir un pointeur vers ces interfaces, reportez-vous à ce qui suit dans la section référence COM :

• Implémentation de fichier composé IPropertySetStorage

  L’implémentation de fichier composé, qui fournit les interfaces IStorage et IStream , fournit également les interfaces IPropertySetStorage et IPropertyStorage . Étant donné une implémentation de fichier composé d’IStorage, l’interface IPropertySetStorage peut être obtenue en appelant IUnknown::QueryInterface.

• IPropertySetStorage –Implémentation du système de fichiers NTFS

  Les interfaces IPropertySetStorage et IPropertyStorage peuvent également être obtenues pour les fichiers NTFS qui ne sont pas des fichiers composés. Par conséquent, il est possible d’obtenir ces interfaces pour tous les fichiers sur un volume NTFS.

• IPropertySetStorage – Implémentation autonome

  Lorsque cette implémentation d’IPropertySetStorage et d’IPropertyStorage est instanciée, elle reçoit un pointeur vers un objet qui prend en charge l’interface IStorage . Il manipule ensuite les stockages d’ensembles de propriétés au sein de cet objet de stockage. Par conséquent, il est possible d’accéder aux jeux de propriétés et de les manipuler sur n’importe quel objet qui prend en charge .

• Considérations relatives à l’implémentation D’IPropertySetStorage

  Il existe plusieurs problèmes à prendre en compte lors de la fourniture d’une implémentation de l’interface IPropertySetStorage . Reportez-vous à ces considérations d’implémentation dans la section Références COM.

En outre, il existe quatre fonctions d’assistance, conçues pour faciliter le traitement des propriétés qui ont été lues à partir d’une propriété définie en mémoire (dans une structure PROPVARIANT ) :

• PropVariantInit
• PropVariantClear
• FreePropVariantArray
• PropVariantCopy

Les sections suivantes décrivent plus en détail les implémentations de jeu de propriétés dans COM :

• Gestion des jeux de propriétés
• Considérations relatives au jeu de propriétés
• Stockage de jeux de propriétés
• Caractéristiques de performances
• Implémentation du jeu de propriétés d’informations récapitulatives
• Considérations relatives à l’implémentation D’IPropertySetStorage