Implémentation autonome IPropertySetStorage

  • Article

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.

IPropertySetStorage::Create

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.

IPropertySetStorage::Open

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é.

IPropertySetStorage::D elete

Supprime un jeu de propriétés dans ce stockage de jeu de propriétés.

IPropertySetStorage::Enum

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 .

 

Implémentation autonome IPropertyStorage

IPropertySetStorage

IPropertyStorage

IStorage::EnumElements

Constantes PROPSETFLAG

STATPROPSETSTG

StgCreatePropSetStg

StgCreatePropStg

StgOpenPropStg

Constantes STGM