Interface IPropertySetStorage (propidl.h)

Article
03/04/2024

L’interface IPropertySetStorage crée, ouvre, supprime et énumère les stockages de jeux de propriétés qui prennent en charge les instances de l’interface IPropertyStorage. L’interface IPropertyStorage gère un ensemble 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 actuellement implémenté 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, que ces jeux résident ou non dans un objet de stockage prenant en charge IStorage. Lorsqu’ils sont appelés via un objet prenant en charge IStorage (tel que les 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 au 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 via 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 les contraintes éventuelles 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 stockage de propriété unique.

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 possède ces méthodes.


IPropertySetStorage ::Create Crée et ouvre un nouveau 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. Au 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.

Remarques

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 en ce qu’il peut avoir deux sections de jeu de propriétés dans un seul flux sous-jacent. Cet ensemble de propriétés est décrit dans Les ensembles de propriétés DocumentSummaryInformation et UserDefined. La première section est l’ensemble de propriétés DocumentSummaryInformation. La deuxième section est le jeu de propriétés UserDefined. Chaque section est identifiée par un identificateur de format unique (FMTID). Par exemple, FMTID_DocSummaryInformation et FMTID_UserDefined ensemble de propriétés. Le fait que ces deux jeux de propriétés puissent 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’a pas besoin d’être créé, mais peut être ouvert 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 de IPropertySetStorage ::D elete, pour supprimer la première section, entraîne la suppression des deux sections. En d’autres termes, l’appel de 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 des jeux de propriétés, le jeu de propriétés UserDefined n’est pas énuméré.

Configuration requise

Condition requise	Valeur
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 (inclure Objbase.h)