Partager via


Interface IPropertyStorage (propidl.h)

L’interface IPropertyStorage gère les propriétés persistantes d’un jeu de propriétés unique. Les propriétés persistantes se composent d’informations qui peuvent être stockées de manière permanente dans un jeu de propriétés, telles que les informations récapitulatives associées à un fichier. Cela contraste avec les propriétés d’exécution associées à Controls et Automation, qui peuvent être utilisées pour affecter le comportement du système. Utilisez les méthodes de l’interface IPropertySetStorage pour créer ou ouvrir un jeu de propriétés persistant. Une instance de l’interface IPropertySetStorage peut gérer zéro ou plusieurs instances IPropertyStorage.

Chaque propriété d’un jeu de propriétés est identifiée par un identificateur de propriété (ID), une valeur ULONG de quatre octets unique à ce jeu. Vous pouvez également attribuer un nom de chaîne à une propriété via l’interface IPropertyStorage .

Les ID de propriété diffèrent des ID de répartition utilisés dans les balises de nom de propriété dispid Automation. Une différence réside dans le fait que l’utilisation à usage général des valeurs d’ID de propriété est zéro et qu’une valeur est interdite dans IPropertyStorage, alors qu’aucune restriction de ce type n’existe dans IDispatch. En outre, bien qu’il existe un chevauchement important entre les types de données pour les valeurs de propriété qui peuvent être utilisées dans IPropertyStorage et IDispatch, les jeux de propriétés ne sont pas identiques. Les types de données de propriété persistante utilisés dans les méthodes IPropertyStorage sont définis dans la structure PROPVARIANT .

L’interface IPropertyStorage peut être utilisée pour accéder à des jeux de propriétés simples et non simples. Les jeux de propriétés non simples peuvent contenir plusieurs types de propriétés complexes qui ne peuvent pas être conservés dans un jeu de propriétés simple. Pour plus d’informations, consultez Stockage et Stream objets pour un jeu de propriétés.

Héritage

L’interface IPropertyStorage hérite de l’interface IUnknown . IPropertyStorage a également les types de membres suivants :

Méthodes

L’interface IPropertyStorage a ces méthodes.

 
IPropertyStorage ::Commit

La méthode IPropertyStorage ::Commit enregistre les modifications apportées à un objet de stockage de propriété dans l’objet de stockage parent.
IPropertyStorage ::D eleteMultiple

La méthode IPropertyStorage ::D eleteMultiple supprime autant de propriétés indiquées qu’il existe dans ce jeu de propriétés.
IPropertyStorage ::D eletePropertyNames

La méthode DeletePropertyNames supprime les noms de chaîne spécifiés du jeu de propriétés actuel. (IPropertyStorage.DeletePropertyNames)
IPropertyStorage ::Enum

La méthode IPropertyStorage ::Enum crée un objet énumérateur conçu pour énumérer des données de type STATPROPSTG, qui contient des informations sur le jeu de propriétés actuel.
IPropertyStorage ::ReadMultiple

La méthode IPropertyStorage ::ReadMultiple lit les propriétés spécifiées à partir du jeu de propriétés actuel.
IPropertyStorage ::ReadPropertyNames

La méthode IPropertyStorage ::ReadPropertyNames récupère tous les noms de chaîne existants pour les ID de propriété spécifiés.
IPropertyStorage ::Revert

La méthode IPropertyStorage ::Revert ignore toutes les modifications apportées au jeu de propriétés nommées depuis sa dernière ouverture ou ignore les modifications qui ont été validées pour la dernière fois dans le jeu de propriétés.
IPropertyStorage ::SetClass

La méthode IPropertyStorage ::SetClass affecte un nouveau CLSID à l’objet de stockage de propriété actuel et stocke de façon permanente le CLSID avec l’objet .
IPropertyStorage ::SetTimes

La méthode IPropertyStorage ::SetTimes définit les heures de modification, d’accès et de création de ce jeu de propriétés, si elles sont prises en charge par l’implémentation.
IPropertyStorage ::Stat

La méthode IPropertyStorage ::Stat récupère des informations sur le jeu de propriétés ouvertes actuel. (IPropertyStorage.Stat)
IPropertyStorage ::WriteMultiple

La méthode IPropertyStorage ::WriteMultiple écrit un groupe de propriétés spécifié dans le jeu de propriétés actuel.
IPropertyStorage ::WritePropertyNames

La méthode IPropertyStorage ::WritePropertyNames affecte la chaîne IPropertyStoragenames à un tableau spécifié d’ID de propriété dans le jeu de propriétés actuel.

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, Propidlbase.h)

Voir aussi

IEnumSTATPROPSETSTG

IEnumSTATPROPSTG

IPropertySetStorage

Implémentation de fichier composé IPropertyStorage

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

Implémentation autonome IPropertyStorage

Gestion des propriétés

PROPVARIANT

Considérations relatives au stockage des propriétés

STATPROPSETSTG

STATPROPSTG

Exemples