Implémentation autonome IPropertySetStorage
L’implémentation autonome fournie par le système d’IPropertySetStorage inclut une implémentation de IPropertyStorage et IPropertySetStorage. IPropertyStorage est l’interface qui lit et écrit les propriétés dans un stockage de jeu de propriétés. IPropertySetStorage est l’interface qui crée et ouvre des jeux de propriétés dans un stockage. Les interfaces IEnumSTATPROPSTG et IEnumSTATPROPSETSTG sont également fournies dans l’implémentation autonome.
Pour utiliser l’implémentation autonome d’IPropertySetStorage, commencez par obtenir un pointeur vers l’implémentation autonome fournie par le système et associez l’implémentation fournie par le système à votre objet de stockage. Pour obtenir un pointeur vers l’implémentation autonome d’IPropertySetStorage, appelez la fonction StgCreatePropSetStg et fournissez le paramètre pStorage spécifiant l’objet de stockage qui contiendra le jeu de propriétés. Cette fonction fournit un pointeur vers la nouvelle interface IPropertySetStorage pour l’objet de stockage spécifié.
L’implémentation autonome d’IPropertySetStorage crée des jeux de propriétés sur n’importe quel objet de stockage, pas seulement sur les stockages de fichiers composés. L’implémentation autonome ne dépend pas de fichiers composés et peut être utilisée avec n’importe quelle implémentation de stockages structurés. Toutes les restrictions sur les stockages structurés fournis par l’appelant s’appliquent à cette implémentation des jeux de propriétés. Par exemple, si vous fournissez un stockage en mode simple à StgOpenPropStg, le IPropertySetStorage résultant sera limité par l’IStorage fourni.
Pour plus d’informations sur l’implémentation de fichiers composés de cette interface, consultez la section IPropertySetStorage-Compound File Implementation.
Quand l’utiliser
Appelez les méthodes de IPropertySetStorage pour créer, ouvrir et supprimer des jeux de propriétés dans n’importe quel stockage structuré. Il existe également une méthode qui fournit un pointeur vers l’énumérateur IEnumSTATPROPSETSTG qui peut être utilisé pour énumérer les jeux de propriétés dans le stockage.
L’implémentation autonome fournit également les fonctions d’assistance StgCreatePropStg et StgOpenPropStg , en plus des méthodes Create et Open , pour créer et ouvrir des jeux de propriétés. Ces deux fonctions ajoutent la prise en charge de la valeur PROPSETFLAG_UNBUFFERED afin que vous puissiez écrire des modifications directement dans le jeu de propriétés au lieu de les mettre en mémoire tampon dans un cache. Pour plus d’informations, consultez Constantes PROPSETFLAG.
Méthodes
L’implémentation autonome d’IPropertySetStorage prend en charge les méthodes suivantes.
-
Crée un jeu de propriétés dans le stockage et retourne un pointeur vers l’interface IPropertyStorage sur le jeu de propriétés.
Si vous envisagez d’utiliser la valeur PROPSETFLAG_UNBUFFERED, utilisez plutôt la fonction StgCreatePropStg pour créer et ouvrir le nouveau jeu de propriétés et obtenir un pointeur vers l’implémentation autonome pour l’interface IPropertyStorage sur le jeu de propriétés.
-
Ouvre un jeu de propriétés existant dans le stockage et retourne un pointeur vers l’interface IPropertyStorage sur le jeu de propriétés.
Si vous envisagez d’utiliser la valeur PROPSETFLAG_UNBUFFERED, utilisez la fonction StgOpenPropStg à la place pour obtenir un pointeur vers l’implémentation autonome d’IPropertyStorage sur le jeu de propriétés spécifié.
-
Supprime un jeu de propriétés dans ce stockage de jeu de propriétés.
-
Crée un objet qui peut être utilisé pour énumérer les structures STATPROPSETSTG . Chaque structure STATPROPSETSTG fournit des données sur un jeu de propriétés unique.
Notes
Le jeu de propriétés DocumentSummaryInformation et UserDefined est unique en ce qu’il peut avoir deux sections de jeu de propriétés dans un seul flux sous-jacent. Pour plus d’informations, consultez Les ensembles de propriétés DocumentSummaryInformation et UserDefined .
Rubriques connexes