Interface IPropertyStorage (propidl.h)

Article
03/01/2024

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)