Interface IPropertySetStorage (propidl.h)

L’interface IPropertySetStorage crée, ouvre, supprime et énumère des stockages de jeux de propriétés qui prennent en charge les instances de l’interface IPropertyStorage . L’interface IPropertyStorage gère un jeu de propriétés unique dans un sous-objet de stockage de propriétés ; et l’interface IPropertySetStorage gère le stockage des groupes de ces jeux de propriétés. Toute entité de système de fichiers peut prendre en charge IPropertySetStorage qui est actuellement implémentée dans l’objet de fichier composé COM.

Les interfaces IPropertySetStorage et IPropertyStorage fournissent un moyen uniforme de créer et de gérer des jeux de propriétés, qu’ils résident ou non dans un objet de stockage qui prend en charge IStorage. Lorsqu’il est appelé par le biais d’un objet prenant en charge IStorage (tel que des fichiers structurés et composés) ou IStream, les jeux de propriétés créés sont conformes au format de jeu de propriétés COM, décrit en détail dans Structured Storage Serialized Property Set Format. De même, les propriétés écrites à l’aide d’IStorage dans le format de jeu de propriétés COM sont visibles via IPropertySetStorage et IPropertyStorage.

Les méthodes IPropertySetStorage identifient les jeux de propriétés par le biais d’un identificateur global unique (GUID) appelé identificateur de format (FMTID). Le FMTID d’un jeu de propriétés identifie les identificateurs de propriété dans le jeu de propriétés, leur signification et toutes les contraintes sur les valeurs. Le FMTID d’un jeu de propriétés doit également fournir les moyens de manipuler ce jeu de propriétés. Une seule instance d’un FMTID donné peut exister à la fois dans un seul stockage de propriétés.

Héritage

L’interface IPropertySetStorage hérite de l’interface IUnknown . IPropertySetStorage possède également les types de membres suivants :

Méthodes

L’interface IPropertySetStorage a ces méthodes.

 
IPropertySetStorage::Create

Crée et ouvre un jeu de propriétés dans l’objet de stockage du jeu de propriétés.
IPropertySetStorage::D elete

La méthode Delete supprime l’un des jeux de propriétés contenus dans l’objet de stockage du jeu de propriétés.
IPropertySetStorage::Enum

La méthode Enum crée un objet énumérateur qui contient des informations sur les jeux de propriétés stockés dans ce stockage de jeux de propriétés. Lors du retour, cette méthode fournit un pointeur vers le pointeur IEnumSTATPROPSETSTG sur l’objet énumérateur.
IPropertySetStorage::Open

Ouvre un jeu de propriétés contenu dans l’objet de stockage du jeu de propriétés.

Notes

Note Il existe une exception à ce qui précède dans le jeu de propriétés DocumentSummaryInformation et UserDefined. Ce jeu de propriétés est unique car il peut avoir deux sections de jeu de propriétés dans un seul flux sous-jacent. Ce jeu de propriétés est décrit dans Les ensembles de propriétés DocumentSummaryInformation et UserDefined. La première section est la propriété DocumentSummaryInformation définie. La deuxième section est la propriété UserDefined définie. Chaque section est identifiée par un identificateur de format unique (FMTID). Par exemple, FMTID_DocSummaryInformation et FMTID_UserDefined propriété définie. Le fait que ces deux jeux de propriétés peuvent exister dans un seul flux affecte le comportement de l’interface IPropertySetStorage .

Lorsque IPropertySetStorage::Create est appelé pour créer le jeu de propriétés UserDefined, la première section est créée automatiquement. Une fois le FMTID_UserDefinedProperties créé, FMTID_DocSummaryInformation n’avez pas besoin d’être créé, mais vous pouvez l’ouvrir avec un appel à IPropertySetStorage::Open. La création de la première section ne crée pas automatiquement la deuxième section et il n’est pas possible d’ouvrir les deux sections simultanément.

L’appel d’IPropertySetStorage::D elete, pour supprimer la première section, entraîne la suppression des deux sections. En d’autres termes, l’appel d’IPropertySetStorage::D elete avec FMTID_DocSummaryInformation entraîne la suppression de cette section et de la section FMTID_UserDefinedProperties. Toutefois, la suppression de la deuxième section ne supprime pas automatiquement la première section.

Lorsque IPropertySetStorage::Enum est utilisé pour énumérer les jeux de propriétés, le jeu de propriétés UserDefined n’est pas énuméré.

 

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête propidl.h (include Objbase.h)

Voir aussi

Exemple EnumAll

IEnumSTATPROPSETSTG

IPropertySetStorage-Compound File Implementation

Implémentation du système de fichiers IPropertySetStorage-NTFS

Implémentation IPropertySetStorage-Autonome

IPropertyStorage

PROPVARIANT

STATPROPSETSTG

Exemples